GeoThai data

Every province, district, subdistrict and postal code of Thailand, checked against official sources.

👉 Latest changes

Features

• Codes, Thai names and English names from the Department of Provincial Administration (DOPA)
• Postal codes per subdistrict. A subdistrict that spans post office zones gets more than one code
• Every value is checked against seven sources before it ships. Each disagreement gets a decision and its evidence
• JSON for code, CSV for spreadsheets, and one nested file for address forms
• Abolished areas in their own file, with the date they ended
• A dated release for each update. A release never changes after it ships

Files

File	Content	Rows
json/provinces.json	Provinces	77
json/districts.json	Districts, with their province	928
json/subdistricts.json	Subdistricts, with their district, province and postal codes	7,436
json/tree.json	Province > district > subdistrict in one nested file	7,436
json/abolished.json	Areas that no longer exist, with the date they ended	1,583
csv/	The same tables as CSV, UTF-8 with a BOM so Excel shows Thai
datapackage.json	Field types, sources, license and row counts

The main files hold active areas only. Codes are strings, and postal_codes is always an array.

A subdistrict looks like this:

{
  "code": "840503",
  "name_th": "เกาะเต่า",
  "name_en": "Ko Tao",
  "district_code": "8405",
  "province_code": "84",
  "postal_codes": ["84360"]
}

Codes nest: 84 is a province, 8405 a district in it, 840503 a subdistrict in that district.

Packages

The same data as a package for JavaScript and Python, with types, lookups by code and postal code, and search by Thai or English name. Each data release ships as a patch version.

Language	Install	Package
JavaScript	npm install geothai	npm, GeoThai/npm-packages
Python	pip install geothai	PyPI, GeoThai/python-library

Usage

To read the files without a package, pin a release, so your data does not change under you. The latest release is on the releases page.

const url =
  "https://cdn.jsdelivr.net/gh/GeoThai/data@v2026.10.20/json/subdistricts.json";
const subdistricts = await (await fetch(url)).json();

import json, urllib.request

url = "https://cdn.jsdelivr.net/gh/GeoThai/data@v2026.10.20/json/subdistricts.json"
subdistricts = json.load(urllib.request.urlopen(url))

Each release also has geothai-json.zip and geothai-csv.zip to download.

Versions

A version is the release date in Thailand: v2026.10.20. A weekly rebuild makes a release only if the data changed. CHANGELOG.md lists each changed area and the reason.

The old data, v1 to v4, stays on the archive branch and the v1 to v4 tags. It has a different format.

Sources

Source	Gives
Department of Provincial Administration	Codes, Thai and English names, abolish dates
thailand-geography-json	Base postal codes
Thailand Post postal code booklet 2558	Postal codes for parts of a subdistrict

Population files, post office lists, Thai Wikipedia and community datasets check these values. They do not add data. The exact files and their hashes are in datapackage.json.

Checks

CI runs these on every push. Each release runs them again before it ships.

bun install
bun run typecheck
bun run check

check reads every file against datapackage.json. It also makes sure that the CSV and JSON files agree, that every area has its parent, and that tree.json matches subdistricts.json.

License

CC BY 4.0 © 2026 Pongsakorn Thipayanate. If you use the data, credit "GeoThai". Source credits and the license of thailand-geography-json are in NOTICE.