Use case

Internal postcode checker for support and sales teams

The problem

Customer support agents and sales teams constantly field the question "do you deliver here?" Without a reliable lookup tool, they check spreadsheets, ask colleagues, or guess. Wrong answers create disappointed customers, failed deliveries, and unnecessary escalations.

How Delivery Zone solves it

Build a simple internal form that calls /api/v1/delivery/check and displays the result. Your team enters a postcode, sees immediately whether you deliver there, what zone it falls in, and what price applies — all in one place, always up to date.

Example API request

# Server-side: check whether a postcode can be delivered to
curl -X POST https://api.deliveryzone.fi/api/v1/delivery/check \
  -H "X-Api-Key: dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destinationPostcode":"00100","basketValueCents":4500}'

# Response: in zone
{
  "canDeliver": true,
  "matchedZoneName": "Helsinki Center",
  "priceCents": 590,
  "currency": "EUR",
  "estimatedDeliveryMinutes": 45,
  "reasonCode": "DELIVERABLE"
}

// Server-side only — never expose your API key in browser code
async function checkDelivery(postcode, basketValueCents) {
  const res = await fetch("https://api.deliveryzone.fi/api/v1/delivery/check", {
    method: "POST",
    headers: {
      "X-Api-Key": process.env.DZ_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ destinationPostcode: postcode, basketValueCents }),
  });
  return res.json();
}

// PHP — server-side, keep API key out of frontend
$response = wp_remote_post('https://api.deliveryzone.fi/api/v1/delivery/check', [
  'headers' => [
    'X-Api-Key'      => get_option('dz_api_key'),
    'Content-Type' => 'application/json',
  ],
  'body' => wp_json_encode([
    'destinationPostcode' => $postcode,
    'basketValueCents'    => $basket_cents,
  ]),
]);
$data = json_decode(wp_remote_retrieve_body($response), true);

Example customer-facing message

We don’t deliver to this postcode. Please check the postcode or choose a different delivery address. Your order has not been charged.

Who this is for

Customer support teams

Sales operations

Logistics coordinators

Internal ops dashboards

Ready to add postcode validation?

Free plan. No credit card. Real setup help.

Start free Read API docs

Try the free postcode checker JavaScript integration API reference