Skip to main content
fastcrw
All providersProvider terms
fastCRW Pergamon
Geocoding · GB

postcodes.io

api.postcodes.io

UK postcode lookup and geocoding: administrative, electoral and health geographies, latitude/longitude, and reverse geocoding from a point, built on Ordnance Survey and Royal Mail data.

Showing the catalogue

1Request

Comma-separated list of postcodes (maximum 100).

1 credit⌘ ↵
Code follows the fields above
curl "https://api.fastcrw.com/v1/data/postcodes-io/bulk-postcodes?q=SW1A1AA%2CSW1A2AA" \
  -H "Authorization: Bearer $FASTCRW_API_KEY"

2Response example

A sample shape. Press Run to see live data from postcodes.io.

JSON
{
  "status": 200,
  "result": null
}

Attribution: Source: postcodes.io. Postcode data from Ordnance Survey and Royal Mail via postcodes.io.

Licence: The postcodes.io site states "Open Source MIT licensed" and its source repository is MIT. That MIT grant covers the SOFTWARE (the API server), not the postcode dataset, which the site attributes to "Ordnance Survey and other UK data providers" without restating their terms. No explicit data-reuse licence is reproduced on the site, so no reuse right is claimed here beyond reading the API.

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Bulk postcode lookup

    Use postcodes.io (postcodes-io) from fastCRW Pergamon, capability "Bulk postcode lookup" (bulk-postcodes). You have a list of UK postcodes and want their geographies in one call. Example options: q=SW1A1AA,SW1A2AA. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "postcodes-io" and capability "bulk-postcodes". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Outcode lookup

    Use postcodes.io (postcodes-io) from fastCRW Pergamon, capability "Outcode lookup" (outcode). You only know the first part of a postcode and need its approximate location and extent. Example options: outcode=SW1A. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "postcodes-io" and capability "outcode". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Postcode lookup

    Use postcodes.io (postcodes-io) from fastCRW Pergamon, capability "Postcode lookup" (postcode). You hold a UK postcode and need its coordinates and administrative areas. Example options: postcode=SW1A 1AA. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "postcodes-io" and capability "postcode". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Reverse geocode

    Use postcodes.io (postcodes-io) from fastCRW Pergamon, capability "Reverse geocode" (reverse-geocode). You have GPS coordinates in the UK and want the postcodes and areas that cover them. Example options: lon=-0.1276, lat=51.5034, limit=10. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "postcodes-io" and capability "reverse-geocode". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>