Introduction
Get started with the Cambodia Postal Code API
Welcome
The Cambodia Postal Code API provides programmatic access to Cambodian postal code data, including provinces, districts, communes, and villages. Use it to build location-based applications, address validators, postal code lookups, and more.
Features
- Comprehensive data — All 25 provinces, 197 districts, 1,646 communes, and 14,372 villages
- Full-text search — Search across all administrative units by name or postal code
- Postal code lookup — Reverse lookup by postal code to get the full administrative hierarchy (province → district → commune)
- Bilingual — All names and types available in English (
en) and Khmer (km) via thelangquery parameter - RESTful API — Simple HTTP endpoints with JSON responses and consistent error handling
- API key authentication — Secure access with TosKey gateway-managed keys
Base URL
| Environment | Base URL |
|---|---|
| Production | https://api.cambodiapostalcode.com/v1 |
All API requests must be authenticated with an API key. See Authentication to get started.
Quick Example
curl -H "x-api-key: YOUR_API_KEY" \
https://api.cambodiapostalcode.com/v1/provinces?lang=enNext Steps
- Authentication — Learn how to get and use API keys
- Quick Start — Make your first API call
- API Reference — Browse all 10 available endpoints