PostalCodes.info

Postal-code lookup, search, country exports, and address validation worldwide. PostalCodes.info publishes a same-origin reference API and bulk CSV / JSON / XLSX downloads for 123+ countries, anchored on GeoNames and national open-data feeds, released under the Open Database License (ODbL) 1.0.

PostalCodes.info publishes 3 APIs on the APIs.io network: Downloads API, Lookup Pages API, and Search API. Tagged areas include Postal Codes, Geocoding, Open Data, Address Validation, and Logistics.

The PostalCodes.info catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

PostalCodes.info’s developer surface includes documentation, GitHub presence, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

42.5/100 developing ▼ -5.0 Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFree

3 APIs

Postal CodesGeocodingOpen DataAddress ValidationLogistics

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 42.5/100 · developing

Contract Quality 17.0 / 25

Developer Ergonomics 1.7 / 20

Commercial Clarity 10.0 / 20

Operational Transparency 0.7 / 13

Governance 7.0 / 12

Discoverability 7.4 / 10

Agent readiness — 25/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/postalcodes-info: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Postalcodes Info Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Examples 7

Example request and response payloads for these APIs.

Scroll for all 7

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

Dataset Documentation

Dataset Documentation

OpenAPI

OpenAPI

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHub

GitHub

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Contact

Contact

Commercial 4

Pricing, plans, and the legal terms of use

License

License

TermsOfService

PrivacyPolicy

Company 1

The organization behind the API

Website

Website

Other 6

Properties that don't map to a standard resource type

DataSources

UpdatePolicy

APIsJSON

Citation

MethodologyNote

CoverageBenchmark

CoverageBenchmark

Source (apis.yml)

aid: postalcodes-info
url: https://raw.githubusercontent.com/api-evangelist/postalcodes-info/refs/heads/main/apis.yml
name: PostalCodes.info
type: Index
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/postalcodes-info.png
description: Postal-code lookup, search, country exports, and address validation worldwide. PostalCodes.info publishes a same-origin
  reference API and bulk CSV / JSON / XLSX downloads for 123+ countries, anchored on GeoNames and national open-data feeds,
  released under the Open Database License (ODbL) 1.0.
created: '2026-05-16'
modified: '2026-05-19'
specificationVersion: '0.20'
tags:
- Postal Codes
- Geocoding
- Open Data
- Address Validation
- Logistics
common:
- type: AgenticAccess
  url: agentic-access/postalcodes-info-agentic-access.yml
- type: DomainSecurity
  url: security/postalcodes-info-domain-security.yml
- url: https://postalcodes.info/
  type: Website
- url: https://postalcodes.info/api
  type: Documentation
- url: https://postalcodes.info/datasets
  type: Dataset Documentation
- url: https://postalcodes.info/openapi.json
  type: OpenAPI
- url: https://postalcodes.info/licensing
  type: License
- url: https://opendatacommons.org/licenses/odbl/1-0/
  type: License
- url: https://postalcodes.info/terms
  type: TermsOfService
- url: https://postalcodes.info/privacy
  type: PrivacyPolicy
- url: https://postalcodes.info/contact
  type: Contact
- url: https://postalcodes.info/data-sources
  type: DataSources
- url: https://postalcodes.info/update-policy
  type: UpdatePolicy
- url: https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json
  type: APIsJSON
- url: https://github.com/PabloCirre/postalcodes-info-open-data
  type: GitHub
- url: https://zenodo.org/records/19493709
  type: Citation
- url: https://zenodo.org/records/19930578
  type: MethodologyNote
- url: https://zenodo.org/records/19930688
  type: CoverageBenchmark
url-source: https://postalcodes.info/
maintainers:
- FN: Pablo Cirre, PostalCodes.info
  url: https://postalcodes.info/contact
  email: social@genera.work
  x-organization: PostalCodes.info (Global Postal Code Repository)
apis:
- aid: postalcodes-info:postalcodes-info-downloads-api
  name: PostalCodes.info Downloads API
  description: Country-level CSV, XLSX and JSON exports.
  humanURL: https://postalcodes.info/api
  baseURL: https://postalcodes.info
  tags:
  - Downloads
  properties:
  - type: OpenAPI
    url: openapi/postalcodes-info-downloads-api-openapi.yml
  - type: Documentation
    url: https://postalcodes.info/api
  - type: Dataset Documentation
    url: https://postalcodes.info/datasets
  - type: License
    url: https://opendatacommons.org/licenses/odbl/1-0/
  - type: License
    url: https://postalcodes.info/licensing
  - type: TermsOfService
    url: https://postalcodes.info/terms
  - type: PrivacyPolicy
    url: https://postalcodes.info/privacy
  - type: UpdatePolicy
    url: https://postalcodes.info/update-policy
  - type: DataSources
    url: https://postalcodes.info/data-sources
  - type: Citation
    url: https://zenodo.org/records/19493709
  - type: APIsJSON
    url: https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json
  - type: GitHub
    url: https://github.com/PabloCirre/postalcodes-info-open-data
  - type: SpectralRules
    url: rules/postalcodes-info-rules.yml
  - type: Plans
    url: plans/postalcodes-info-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/postalcodes-info-rate-limits.yml
  - type: FinOps
    url: finops/postalcodes-info-finops.yml
  - type: Vocabulary
    url: vocabulary/postalcodes-info-vocabulary.yml
  - type: JSONLD
    url: json-ld/postalcodes-info-context.jsonld
  - type: JSONSchema
    url: json-schema/postalcodes-info-postal-record-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-search-suggestion-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-error-schema.json
  - type: JSONStructure
    url: json-structure/postalcodes-info-postal-record-structure.json
  - type: Examples
    url: examples/postalcodes-info-search-postal-codes-example.json
  - type: Examples
    url: examples/postalcodes-info-preview-country-records-example.json
  - type: Examples
    url: examples/postalcodes-info-create-download-token-example.json
  - type: Examples
    url: examples/postalcodes-info-download-country-dataset-example.json
  - type: Examples
    url: examples/postalcodes-info-get-country-lookup-page-example.json
  - type: Examples
    url: examples/postalcodes-info-postal-record-example.json
  - type: Examples
    url: examples/postalcodes-info-search-suggestion-example.json
- aid: postalcodes-info:postalcodes-info-lookup-pages-api
  name: PostalCodes.info Lookup Pages API
  description: Canonical HTML pages for manual review and citation.
  humanURL: https://postalcodes.info/api
  baseURL: https://postalcodes.info
  tags:
  - Lookup Pages
  properties:
  - type: OpenAPI
    url: openapi/postalcodes-info-lookup-pages-api-openapi.yml
  - type: Documentation
    url: https://postalcodes.info/api
  - type: Dataset Documentation
    url: https://postalcodes.info/datasets
  - type: License
    url: https://opendatacommons.org/licenses/odbl/1-0/
  - type: License
    url: https://postalcodes.info/licensing
  - type: TermsOfService
    url: https://postalcodes.info/terms
  - type: PrivacyPolicy
    url: https://postalcodes.info/privacy
  - type: UpdatePolicy
    url: https://postalcodes.info/update-policy
  - type: DataSources
    url: https://postalcodes.info/data-sources
  - type: Citation
    url: https://zenodo.org/records/19493709
  - type: APIsJSON
    url: https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json
  - type: GitHub
    url: https://github.com/PabloCirre/postalcodes-info-open-data
  - type: SpectralRules
    url: rules/postalcodes-info-rules.yml
  - type: Plans
    url: plans/postalcodes-info-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/postalcodes-info-rate-limits.yml
  - type: FinOps
    url: finops/postalcodes-info-finops.yml
  - type: Vocabulary
    url: vocabulary/postalcodes-info-vocabulary.yml
  - type: JSONLD
    url: json-ld/postalcodes-info-context.jsonld
  - type: JSONSchema
    url: json-schema/postalcodes-info-postal-record-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-search-suggestion-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-error-schema.json
  - type: JSONStructure
    url: json-structure/postalcodes-info-postal-record-structure.json
  - type: Examples
    url: examples/postalcodes-info-search-postal-codes-example.json
  - type: Examples
    url: examples/postalcodes-info-preview-country-records-example.json
  - type: Examples
    url: examples/postalcodes-info-create-download-token-example.json
  - type: Examples
    url: examples/postalcodes-info-download-country-dataset-example.json
  - type: Examples
    url: examples/postalcodes-info-get-country-lookup-page-example.json
  - type: Examples
    url: examples/postalcodes-info-postal-record-example.json
  - type: Examples
    url: examples/postalcodes-info-search-suggestion-example.json
- aid: postalcodes-info:postalcodes-info-search-api
  name: PostalCodes.info Search API
  description: Interactive postal-code and locality lookup.
  humanURL: https://postalcodes.info/api
  baseURL: https://postalcodes.info
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/postalcodes-info-search-api-openapi.yml
  - type: Documentation
    url: https://postalcodes.info/api
  - type: Dataset Documentation
    url: https://postalcodes.info/datasets
  - type: License
    url: https://opendatacommons.org/licenses/odbl/1-0/
  - type: License
    url: https://postalcodes.info/licensing
  - type: TermsOfService
    url: https://postalcodes.info/terms
  - type: PrivacyPolicy
    url: https://postalcodes.info/privacy
  - type: UpdatePolicy
    url: https://postalcodes.info/update-policy
  - type: DataSources
    url: https://postalcodes.info/data-sources
  - type: Citation
    url: https://zenodo.org/records/19493709
  - type: APIsJSON
    url: https://raw.githubusercontent.com/PabloCirre/postalcodes-info-open-data/main/apis.json
  - type: GitHub
    url: https://github.com/PabloCirre/postalcodes-info-open-data
  - type: SpectralRules
    url: rules/postalcodes-info-rules.yml
  - type: Plans
    url: plans/postalcodes-info-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/postalcodes-info-rate-limits.yml
  - type: FinOps
    url: finops/postalcodes-info-finops.yml
  - type: Vocabulary
    url: vocabulary/postalcodes-info-vocabulary.yml
  - type: JSONLD
    url: json-ld/postalcodes-info-context.jsonld
  - type: JSONSchema
    url: json-schema/postalcodes-info-postal-record-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-search-suggestion-schema.json
  - type: JSONSchema
    url: json-schema/postalcodes-info-error-schema.json
  - type: JSONStructure
    url: json-structure/postalcodes-info-postal-record-structure.json
  - type: Examples
    url: examples/postalcodes-info-search-postal-codes-example.json
  - type: Examples
    url: examples/postalcodes-info-preview-country-records-example.json
  - type: Examples
    url: examples/postalcodes-info-create-download-token-example.json
  - type: Examples
    url: examples/postalcodes-info-download-country-dataset-example.json
  - type: Examples
    url: examples/postalcodes-info-get-country-lookup-page-example.json
  - type: Examples
    url: examples/postalcodes-info-postal-record-example.json
  - type: Examples
    url: examples/postalcodes-info-search-suggestion-example.json
features:
- Same-origin lookup search across countries, localities and postal codes
- Country preview endpoint returning up to 25,000 records for UI previews
- Bulk country dataset exports in CSV, JSON, and XLSX formats
- Token-gated downloads to prevent hotlinking and abusive scraping
- 123+ country coverage with 1.83M postal records and 99.2% geocoding rate
- WGS84 latitude/longitude on locality centroids (where coverage exists)
- Postal codes preserved as strings to retain leading zeros, spaces, and punctuation
- Annual master snapshot (e.g., 2026.1) plus weekly minor refreshes
- Open Database License (ODbL) 1.0 licensing for redistribution and derivatives
- Public OpenAPI 3.1 specification at /openapi.json
use-cases:
- Address-form autocomplete and validation in e-commerce checkouts
- Postal-code prefix and range lookup for logistics zone normalization
- Geocoding centroids for shipping rate previews and store locator UIs
- Data-quality checks and entity reconciliation in master data pipelines
- Locality and administrative-hierarchy enrichment for CRM and CDP records
- Country onboarding for SaaS apps that need bundled postal references
- Research, education, and benchmarking against open postal corpora
- Citation-grade postal corpora for academic and methodology publications
integrations:
- name: GeoNames
  url: https://www.geonames.org/
  description: Upstream provider of place, administrative hierarchy and WGS84 coordinate fields underpinning most country
    corpora.
- name: Saudi Post (SPL)
  url: https://splonline.com.sa/
  description: Open-data workbooks contributing Saudi Arabia branch postal-code material.
- name: Kazakhstan National Open-Government Postal Index
  url: https://data.egov.kz/
  description: Open-data postal reference for Kazakhstan.
- name: Oracle Cloud
  url: https://www.oracle.com/cloud/
  description: Hosting and CDN infrastructure for postalcodes.info.
- name: Zenodo
  url: https://zenodo.org/
  description: Persistent DOI for dataset snapshots, methodology and coverage benchmarks.
solutions:
- name: E-Commerce Address Validation
  description: Drop-in postal lookup and locality suggestion to clean cart addresses and reduce shipping rejections.
  tags:
  - E-Commerce
  - Address Validation
- name: Logistics Zone Normalization
  description: Country dataset exports to drive carrier zone, postal-prefix and routing tables in fulfillment systems.
  tags:
  - Logistics
  - Geocoding
- name: Master Data Quality
  description: Reference corpora for entity reconciliation and locality enrichment across CRM, CDP and ERP systems.
  tags:
  - Data Quality
  - Master Data Management
- name: Open Research Reference
  description: Citation-grade postal data with Zenodo DOIs supporting reproducible methodology and coverage benchmarks.
  tags:
  - Open Data
  - Research
include: []
x-common:
- type: Vocabulary
  url: vocabulary/postalcodes-info-vocabulary.yml
- type: Plans
  url: plans/postalcodes-info-plans-pricing.yml
- type: RateLimits
  url: rate-limits/postalcodes-info-rate-limits.yml
- type: FinOps
  url: finops/postalcodes-info-finops.yml

PostalCodes.info

APIs 3

Open Collections 1

Pricing Plans 1