Quick Start

1. Get Your API Key

2. Make Your First Request

List all provinces:

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.cambodiapostalcode.com/v1/provinces?lang=en

Response:

{
  "statusCode": 200,
  "data": [
    {
      "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"
  }
}

3. Look Up a Postal Code

Reverse-lookup a postal code to get the full administrative hierarchy (province → district → commune):

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.cambodiapostalcode.com/v1/lookup/120101?lang=en

4. Search

Full-text search across all administrative units by name or postal code:

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.cambodiapostalcode.com/v1/search?q=phnom+penh&lang=en

Next Steps

API Reference — Full endpoint documentation
Error Handling — Understand error responses
Rate Limits — Know your quotas