CambodiaPostalCode Dev
API ReferencePricing
CambodiaPostalCode Dev

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

GitHubTwitter / X
Early access — free API keys

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
Browse docs

Getting Started

  • Introduction
  • Authentication
  • Quick Start

API Reference

  • All Provinces
  • Province by Code
  • Districts
  • Communes
  • Villages
  • Search

Resources

  • Error Handling
  • Rate Limits
  • SDKs & Libraries
DocsAPI ReferenceSearch

API Reference

Search Locations

GET /v1/search — full-text search across all location types by name or postal code.

GET/v1/search?q={query}

Search across provinces, districts, communes, and villages by English name, Khmer name, or postal code.

Query Parameters

ParameterTypeRequiredDescription
qstringrequiredSearch query — name or postal code
typestringoptionalFilter by type: province | district | commune | village
limitintegeroptionalMax results to return (default 20, max 100)

Response

json
{
  "status": "success",
  "data": {
    "query": "Phnom Penh",
    "results": [
      {
        "type": "province",
        "code": "12",
        "name_en": "Phnom Penh",
        "name_km": "ភ្នំពេញ",
        "postal_code": "12000"
      }
    ],
    "total": 1
  }
}

Playground

GET/v1/searchPlayground

Query Parameters

qstringrequired

Search query — name or postal code

typestring

Filter: province | district | commune | village

limitinteger

Max results (default 20, max 100)

Request URL

https://api.cambodiapostalcode.com/v1/search?q=Phnom+Penh

cURL

curl -X GET "https://api.cambodiapostalcode.com/v1/search?q=Phnom+Penh" \
  -H "Content-Type: application/json"
PreviousVillagesAPI ReferenceNext Error HandlingResources

Last updated June 2025

Try it

Live
GET/v1/searchPlayground

Query Parameters

qstringrequired

Search query — name or postal code

typestring

Filter: province | district | commune | village

limitinteger

Max results (default 20, max 100)

Request URL

https://api.cambodiapostalcode.com/v1/search?q=Phnom+Penh

cURL

curl -X GET "https://api.cambodiapostalcode.com/v1/search?q=Phnom+Penh" \
  -H "Content-Type: application/json"

Quick links

View Pricing Get API Key