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

Get all provinces

GET
/provinces

Retrieve a paginated list of all 25 provinces in Cambodia. Each province includes its UUID, localized name, type, and postal code prefix/range. Use the lang query parameter to switch between English (en) and Khmer (km).

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

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

curl -X GET "https://example.com/provinces?lang=en"
{  "statusCode": 200,  "data": {    "items": [      {        "id": "3842cac4-b9a0-8223-0dcc-509a6f75849b",        "name": "Banteay Meanchey Province",        "slug": "banteay-meanchey-provine",        "type": "Province",        "prefix": "01",        "postalCodePrefix": "01"      },      {        "id": "8d721ec8-4c9d-632f-6f06-7f89cc14862c",        "name": "Battambang Province",        "slug": "battambang-provine",        "type": "Province",        "prefix": "02",        "postalCodePrefix": "02"      }    ]  },  "metadata": {    "correlationId": "01a0642a-d55f-70f8-b40f-2ce1c5c12035"  }}

API Reference

Complete reference for all Cambodia Postal Code API endpoints

Get province by ID GET

Next Page