CPCCambodiaPostalCode Dev
API ReferencePricing
CPCCambodiaPostalCode Dev

REST API for Cambodia address data — provinces, districts, communes, and villages. Free to start, no credit card required.

GitHubTwitter / X
Free API — no credit card required

Docs

  • Introduction
  • Quick Start
  • API Reference
  • Authentication
  • Error Codes
  • Rate Limits

Product

  • Pricing
  • Use Cases
  • Dashboard
  • API Keys
  • Changelog
  • Status

Community

  • GitHub
  • Blog
  • Changelog
  • Discussions
  • Contact

Company

  • About
  • Privacy Policy
  • Terms of Service

© 2026 CambodiaPostalCode Dev. Built for developers.

PrivacyTermsContactChangelogGitHub
CambodiaPostalCode Dev
CambodiaPostalCode Dev
DocsAPI ReferenceHomeIntroduction
API ReferenceGet all provinces GETGet province by ID GETGet districts by province GETGet district by ID GETGet communes by district GETGet commune by ID GETGet villages by commune GETGet village by ID GETSearch administrative units GETLookup postal code GET

Lookup postal code

GET
/lookup/{postcode}

Reverse lookup by postal code — pass a postal code (e.g. 120101) and receive the full administrative hierarchy (province, district, commune) that the code maps to, including localized names and slugs.

Authorization

ApiKeyAuth
x-api-key<token>

API key passed in the x-api-key header. Obtain a key from the developer dashboard. Example: x-api-key: YOUR_API_KEY

In: header

Path Parameters

postcode*string

The postal code to lookup

Length1 <= length

Query Parameters

lang?string

Language for the response (en or km)

Default"en"

Value in

  • "en"
  • "km"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/lookup/120101?lang=en"

{  "statusCode": 200,  "data": {    "slug": "sangkat-tonle-basak",    "name": "Sangkat Tonle Basak",    "type": "commune",    "postal_code": "00120101",    "postal_code_prefix": "120101",    "postal_code_range": "12010100-12010199",    "province_slug": "phnom-penh-capital",    "province_name": "Phnom Penh Capital",    "district_slug": "khan-chamkar-mon",    "district_name": "Khan Chamkar Mon",    "commune_slug": "sangkat-tonle-basak",    "commune_name": "Sangkat Tonle Basak"  },  "metadata": {    "correlationId": "01a0642a-d55f-70f8-b40f-2ce1c5c12035"  }}

Search administrative units GET

Previous Page

Error Handling

Understand API error responses and status codes