PostalCodes.info

PostalCodes.info Lookup Pages API

Canonical HTML pages for manual review and citation.

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://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/openapi/postalcodes-info-lookup-pages-api-openapi.yml

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

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

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

OpenAPI Specification

openapi: 3.1.0
info:
  title: PostalCodes.info Postal Code Reference Downloads Lookup Pages API
  summary: Same-origin postal-code search, country export and lookup-page endpoints.
  description: PostalCodes.info exposes postal-code reference data for lookup, testing, education, geospatial examples and data-quality workflows. Coverage and granularity vary by country. This is not an official delivery-grade postal authority API; validate shipping, compliance and certified address decisions against the relevant national postal authority.
  version: '2026-05-05'
  contact:
    name: Pablo Cirre, PostalCodes.info
    url: https://postalcodes.info/contact
    email: social@genera.work
  license:
    name: Open Database License 1.0
    url: https://opendatacommons.org/licenses/odbl/1-0/
servers:
- url: https://postalcodes.info
  description: Canonical production host
tags:
- name: Lookup Pages
  description: Canonical HTML pages for manual review and citation.
paths:
  /postal-codes/{country}:
    get:
      tags:
      - Lookup Pages
      summary: Open a Country Postal-Code Reference Page
      operationId: getCountryLookupPage
      parameters:
      - name: country
        in: path
        required: true
        description: Country slug.
        schema:
          type: string
          examples:
          - spain
          - united-states
          - india
      responses:
        '200':
          description: Canonical HTML page for a country dataset.
          content:
            text/html:
              schema:
                type: string