THE DEVELOPER WORKSPACE / API V1

Less friction. More building.

OpenAPI reference

Make a real request. Inspect the response. Take the code with you.

Request builder01

GET

/v1/postcodes/{code}

Resolve a postcode into coordinates, lifecycle dates, and administrative context.

Responseapplication/json

Your next integration starts here.

Send a request to inspect a live JSON response.

Take it to your terminal

curl --get 'https://api.postcoders.co.uk/v1/postcodes/SW1A%201AA' \
  --header 'Accept: application/json'

Predictable limits

Default: 120 requests per minute per IP. Read the rate-limit headers and respect Retry-After.

Know the source

Results identify their source. A postcode centroid is distinct from a property point, which may be approximate. Address data © OpenStreetMap contributors, ODbL.

Clear failure states

404 for missing postcodes, 422 for invalid input, 429 for quotas, and 503 for service interruptions.