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
Documentation
https://postalcodes.info/api
RateLimits
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/rate-limits/postalcodes-info-rate-limits.yml
Specifications
OpenAPI
https://postalcodes.info/openapi.json
OpenAPI
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/openapi/postalcodes-info-openapi.yml
Schemas & Data
JSONSchema
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-postal-record-schema.json
JSONSchema
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-search-suggestion-schema.json
JSONSchema
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-schema/postalcodes-info-error-schema.json
JSONStructure
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
License
https://opendatacommons.org/licenses/odbl/1-0/
License
https://postalcodes.info/licensing
TermsOfService
https://postalcodes.info/terms
PrivacyPolicy
https://postalcodes.info/privacy
UpdatePolicy
https://postalcodes.info/update-policy
DataSources
https://postalcodes.info/data-sources
Citation
https://zenodo.org/records/19493709
APIsJSON
https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json
GitHub
https://github.com/PabloCirre/postalcodes-info-open-data
SpectralRules
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/rules/postalcodes-info-rules.yml
Plans
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/plans/postalcodes-info-plans-pricing.yml
FinOps
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/finops/postalcodes-info-finops.yml
Vocabulary
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/vocabulary/postalcodes-info-vocabulary.yml
JSONLD
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/json-ld/postalcodes-info-context.jsonld
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-search-postal-codes-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-preview-country-records-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-create-download-token-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-download-country-dataset-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-get-country-lookup-page-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-postal-record-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/examples/postalcodes-info-search-suggestion-example.json