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 village by ID

GET
/villages/{id}

Retrieve detailed information about a single village, including its postal code and the full parent hierarchy (commune, district, province IDs and names).

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

id*string

Unique identifier of the village

Formatuuid

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/villages/a1b2c3d4-e5f6-7890-abcd-ef1234567890?lang=en"
{  "statusCode": 200,  "data": {    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",    "name": "Phnum Srok",    "type": "village",    "postal_code": "11101",    "commune_id": "beb0bdbe-4858-5cb9-87d6-4885734f38c0",    "commune_name": "Phnum Srok",    "district_id": "63c022ca-68c7-5074-b508-9b78f745ee8c",    "district_name": "Mongkol Borei",    "province_id": "79974b80-2e1c-5ffb-9e1d-caba0a2d0a0e",    "province_name": "Banteay Meanchey"  },  "metadata": {    "correlationId": "01a0642a-d55f-70f8-b40f-2ce1c5c12035"  }}

Get villages by commune GET

Previous Page

Search administrative units GET

Next Page