PostalCodes.info

PostalCodes.info Postal Code Reference API

Same-origin postal-code search, country export, and lookup-page endpoints used by the public PostalCodes.info UI. Coverage spans 123+ countries with approximately 1.83M postal records and 99.2% geocoding coverage on locality centroids. Designed for lookup, testing, education, geospatial examples, and data-quality workflows. Not a delivery-grade postal authority API.

Documentation GitHub OpenAPI

Documentation

https://postalcodes.info/api

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/rate-limits/postalcodes-info-rate-limits.yml

Specifications

https://postalcodes.info/openapi.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/openapi/postalcodes-info-openapi.yml

Examples

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-search-postal-codes-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-preview-country-records-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-create-download-token-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-download-country-dataset-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-get-country-lookup-page-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-postal-record-example.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-search-suggestion-example.json

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-postal-record-schema.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-search-suggestion-schema.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-error-schema.json

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-structure/postalcodes-info-postal-record-structure.json

Other Resources

Dataset Documentation

https://postalcodes.info/datasets

https://opendatacommons.org/licenses/odbl/1-0/

https://postalcodes.info/licensing

https://postalcodes.info/terms

https://postalcodes.info/privacy

https://postalcodes.info/update-policy

https://postalcodes.info/data-sources

https://zenodo.org/records/19493709

https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json

https://github.com/PabloCirre/postalcodes-info-open-data

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/rules/postalcodes-info-rules.yml

NaftikoCapabilities

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/capabilities/postal-data-lookup.yaml

NaftikoCapabilities

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/capabilities/country-dataset-export.yaml

NaftikoCapabilities

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/capabilities/shared/postalcodes-info-postal-code-reference-api.yaml

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/plans/postalcodes-info-plans-pricing.yml

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/finops/postalcodes-info-finops.yml

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/vocabulary/postalcodes-info-vocabulary.yml

https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-ld/postalcodes-info-context.jsonld

OpenAPI Specification