Skip to content

Countries & Cambodia Provinces API

Country pickers, phone code lists and a Cambodia province dropdown, ready as JSON.

Nearly every sign-up form needs a country picker with flags and phone codes, and Cambodian apps need a province list. This API gives you 198 countries and territories with ISO codes, capital, region, currency, calling code, main languages and a flag emoji, plus the 25 provinces of Cambodia with Khmer names, ISO 3166-2 codes, provincial capitals and coordinates.

The facts are stable, but they are provided for learning and prototypes: check an official source before relying on them.

Base URL https://toolorca.com/api/v1 No key · CORS open · JSON · conventions and limits

Endpoints

GET /api/v1/countries #

All countries, with search, filters, sorting and pagination.

Parameter In Type Description
region query string Asia, Europe, Africa, Americas or Oceania.
subregion query string e.g. South-Eastern Asia.
currency query string ISO currency code, e.g. EUR.
language query string ISO 639-1 code, e.g. fr.
callingCode query string e.g. 855.
q query string Full-text search in the main text fields.
sortBy query string Field to sort by, e.g. price or rating.rate.
order query string asc (default) or desc.
select query string Comma-separated fields to return, e.g. title,price (id is always included).
limit query integer Items per page (default 50, max 250).
skip query integer Items to skip, for offset pagination.
page query integer 1-based page number; used when skip is not given.
curl 'https://toolorca.com/api/v1/countries?subregion=South-Eastern%20Asia&select=name,capital,currency,callingCode,flag'
GET /countries?subregion=South-Eastern%20Asia&select=name,cap…
Example response
{
  "data": [
    {
      "name": "Brunei",
      "capital": "Bandar Seri Begawan",
      "currency": "BND",
      "callingCode": "+673",
      "flag": "🇧🇳"
    },
    {
      "name": "Cambodia",
      "capital": "Phnom Penh",
      "currency": "KHR",
      "callingCode": "+855",
      "flag": "🇰🇭"
    },
    {
      "name": "Indonesia",
      "capital": "Jakarta",
      "currency": "IDR",
      "callingCode": "+62",
      "flag": "🇮🇩"
    },
    "… 8 more"
  ],
  "meta": {
    "total": 11,
    "limit": 50,
    "skip": 0,
    "page": 1,
    "pages": 1
  }
}

GET /api/v1/countries/{code} #

One country by its two- or three-letter ISO code.

Parameter In Type Description
code required path string KH or KHM.
curl 'https://toolorca.com/api/v1/countries/KH'
GET /countries/KH
Example response
{
  "code": "KH",
  "code3": "KHM",
  "name": "Cambodia",
  "nameKm": "កម្ពុជា",
  "capital": "Phnom Penh",
  "region": "Asia",
  "subregion": "South-Eastern Asia",
  "currency": "KHR",
  "callingCode": "+855",
  "languages": [
    {
      "code": "km",
      "name": "Khmer"
    }
  ],
  "flag": "🇰🇭",
  "flagCode": "kh",
  "tld": ".kh"
}

GET /api/v1/cambodia/provinces #

The 25 provinces (24 provinces and the capital, Phnom Penh) in ISO order.

Parameter In Type Description
zone query string plain, tonle sap, coastal or plateau.
q query string Search English or Khmer names.
sortBy query string e.g. name.
curl 'https://toolorca.com/api/v1/cambodia/provinces?select=name,nameKm,code,capital&limit=5'
GET /cambodia/provinces?select=name,nameKm,code,capital&limit=5
Example response
{
  "data": [
    {
      "id": "banteay-meanchey",
      "name": "Banteay Meanchey",
      "nameKm": "បន្ទាយមានជ័យ",
      "code": "KH-1",
      "capital": "Serei Saophoan"
    },
    {
      "id": "battambang",
      "name": "Battambang",
      "nameKm": "បាត់ដំបង",
      "code": "KH-2",
      "capital": "Battambang"
    },
    {
      "id": "kampong-cham",
      "name": "Kampong Cham",
      "nameKm": "កំពង់ចាម",
      "code": "KH-3",
      "capital": "Kampong Cham"
    },
    "… 2 more"
  ],
  "meta": {
    "total": 25,
    "limit": 5,
    "skip": 0,
    "page": 1,
    "pages": 5
  }
}

GET /api/v1/cambodia/provinces/{id} #

One province by id, ISO code or number.

Parameter In Type Description
id required path string siem-reap, KH-17 or 17.
curl 'https://toolorca.com/api/v1/cambodia/provinces/siem-reap'
GET /cambodia/provinces/siem-reap
Example response
{
  "id": "siem-reap",
  "code": "KH-17",
  "number": 17,
  "name": "Siem Reap",
  "nameKm": "សៀមរាប",
  "type": "province",
  "typeKm": "ខេត្ត",
  "capital": "Siem Reap",
  "zone": "Tonle Sap",
  "zoneKm": "តំបន់ទន្លេសាប",
  "lat": 13.3618,
  "lon": 103.8607,
  "country": "Cambodia",
  "countryCode": "KH",
  "timezone": "Asia/Phnom_Penh"
}

A phone number field with country codes

Load /countries?select=name,callingCode,flag&limit=0 once, keep it in the app and show flag with callingCode in the picker. Put Cambodia first for Cambodian users with /countries/KH. The response is cacheable for a day.

Free daily limit

Shared with the other mock services: 50 requests per day and 10 per minute per IP address. Country and province data almost never changes, so download it once and bundle it.

Frequently asked questions

Does it include Cambodian districts and communes?

Not yet: only the 25 provinces. They include Khmer names, ISO 3166-2 codes (KH-1 to KH-25), provincial capitals, geographic zones and coordinates.

Where do the flag images come from?

The API returns a flag emoji and a lower-case flagCode that matches open-source flag sets such as flag-icons.

Are Khmer country names included?

For Cambodia, its neighbours and the countries Cambodian users look up most, in nameKm; other countries return null.

Can I use it offline?

Yes. The lists are small: fetch them once and store them in your app.

More free APIs