Postcodes

Every postcode in a country, grouped by region

The whole index in one response, which is how a postcode list is read and what makes it cacheable. Large for a big country: fetch it once and keep it rather than asking per keystroke.

get/v1/countries/{country}/postcodes

Request

  • Base URL: https://api.postfinder.io
  • URL: https://api.postfinder.io/v1/countries/{country}/postcodes
  • Auth: none required

Path parameters

countrystring required

Country slug as the site's URLs use it: australia, new-zealand, united-kingdom, united-states, canada.

Response

The index.

generated_atstring date-time required

When the answer was made. Answers are cached at the edge, so it can be up to an hour old.

Changes

No recorded changes to this operation across all 1 revision of this API.