API Information

A reference overview of how the Postcode Finder lookup API is structured. This page documents the interface shape for demo purposes.

Overview

The lookup API accepts a country, and one or more of city, street, or postal code, and returns the closest matching postcode record including coordinates and delivery zone.

Endpoints

GET /v1/lookup?country=GB&city=Manchester Find postcode by city

GET /v1/reverse?postcode=M1+1AE&country=GB Reverse lookup by postcode

GET /v1/coverage List supported countries

Example request

GET /v1/lookup?country=GB&city=Manchester
Host: api.postcodefinder.example
Accept: application/json

Example response

{
  "postcode": "M1 1AE",
  "city": "Manchester",
  "state": "Greater Manchester",
  "country": "United Kingdom",
  "latitude": 53.4808,
  "longitude": -2.2426,
  "deliveryArea": "Zone M1 — Central"
}

Access

API access isn't live on this demo build. If you're evaluating Postcode Finder for a real integration, use the contact form to request access details.