Thailand Formats API

Free REST API for Thai public holidays, real-time alcohol sales status, date info, unit conversions, and ID card validation. All endpoints return JSON.

Base URL: https://thailandformats.com/api/v1
Rate Limit: 60 requests/minute per IP
Auth: None required (public API)

Holidays

GET /api/v1/holidays/{year}

Get all Thai public holidays for a given year.

Try it →

Date Information

GET /api/v1/date/{YYYY-MM-DD}

Get info for a specific date: Thai year, day colour, holidays, alcohol ban status.

Try it →

Alcohol Status

GET /api/v1/alcohol

Real-time: can you buy alcohol in Thailand right now?

Try it →

Working Days

GET /api/v1/working-days

Calculate Thai business days. Excludes weekends and public holidays.

start_date	Required. YYYY-MM-DD.
end_date	YYYY-MM-DD. Required unless using add_days.
add_days	Integer. Add N business days from start_date instead.

Try it →

Unit Conversion

GET /api/v1/convert/area

Convert between Thai and international area units.

amount	Number (default: 1)
from	rai, ngan, wah, sqm, acre, hectare, sqmile
to	Same options

Try it →

GET /api/v1/convert/distance

Convert between Thai and international distance units.

amount	Number (default: 1)
from	wa, sen, yot, cm, m, km, in, ft, mile
to	Same options

Try it →

ID Card Validation

GET /api/v1/validate/idcard/{number}

Validate a Thai 13-digit ID card number.

Try it →

Calendar Subscription

Subscribe URL (auto-updating): https://thailandformats.com/calendar/thai-holidays.ics

Add to Google Calendar, Apple Calendar, or Outlook. Updates automatically.

Download 2026 holidays (.ics)