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

39.1/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessFree

3 APIs

Postal CodesGeocodingOpen DataAddress ValidationLogistics

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 39.1/100 · thin

Contract Quality 13.5 / 21

Developer Ergonomics 1.6 / 17

Access Clarity 8.5 / 17

Operational Transparency 0.6 / 11

Contract Governance 1.0 / 10

Discoverability 6.3 / 9

Regulatory Posture 5.3 / 15

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 9 / 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 4 / 4

Regulatory Posture applies to this provider. Its tags matched the Government & Public Sector regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

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.23'
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 5

Pricing Plans 1