Thai Holiday Data API

Returns Thai public and financial-institution holidays for a year, a date range or a window around today, each with its date, weekday and name.

GET/v3/store/data/thai-holiday

+1 endpoints

Try it

• Price0.1 ICper request
• Capacity1000 requests/hour
• Served54.6Kcalls

• v1.0
• Active

Input

holiday_type

public

days_after

365

OutputGET /v3/store/data/thai-holiday

holidays

2 × { date, date_thai, weekday, weekday_thai, name, name_thai, type }

total_count

25

date_range

start_date: 2025-06-08 end_date: 2026-06-08 query_type: range reference_date: 2025-06-08

holiday_types

public

cached_at

2025-06-08T10:29:33.740056

Every field, under ResponseOther endpoints: /range see Request

Request

curl -X GET "https://api.iapp.co.th/v3/store/data/thai-holiday?holiday_type=public&days_after=365" \
    -H "apikey: YOUR_API_KEY"

Response

200OK. The fields are explained under Response.

{
    "holidays": [
        {
            "date": "2025-07-10",
            "date_thai": null,
            "weekday": "Thursday", 
            "weekday_thai": null,
            "name": "วันอาสาฬหบูชา",
            "name_thai": null,
            "type": "public"
        },
        {
            "date": "2025-07-28",
            "date_thai": null,
            "weekday": "Monday",
            "weekday_thai": null,
            "name": "วันเฉลิมพระชนมพรรษา สมเด็จพระเจ้าอยู่หัวมหาวชิราลงกรณ บดินทรเทพยวรางกูร",
            "name_thai": null,
            "type": "public"
        }
    ],
    "total_count": 25,
    "date_range": {
        "start_date": "2025-06-08",
        "end_date": "2026-06-08",
        "query_type": "range",
        "reference_date": "2025-06-08"
    },
    "holiday_types": ["public"],
    "cached_at": "2025-06-08T10:29:33.740056"
}

Request

GET with query parameters; 0.1 IC per request on every endpoint.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

holiday_typestring

public, the default, financial, or both.

days_beforedays_afterinteger

Days before and after today, each up to 1,825; defaults 0 and 365.

yearinteger

A year from 2020 to 2030; overrides the window.

start_dateend_datestring

For /range: YYYY-MM-DD, both required there.

Endpoint	Returns
/v3/store/data/thai-holiday	The holidays in the window, or in the year
/v3/store/data/thai-holiday/year/{year}	A whole year
/v3/store/data/thai-holiday/range	The holidays between two dates
/v3/store/data/thai-holiday/types	The holiday types

The legacy path /data/thai-holidays/holidays answers at the same price.

Response

As in the panel: holidays[], each with date, weekday, name, type (public or financial) and, where available, date_thai, weekday_thai and name_thai; total_count; the date_range resolved from your query; and cached_at.

As in the panel: holidays[], each with date, weekday, name, type (public or financial) and, where available, date_thai, weekday_thai and name_thai; total_count; the date_range resolved from your query; and cached_at.

Status codes

400 and 422 for an invalid parameter, such as a date not in YYYY-MM-DD or an unknown holiday_type, with detail[] naming the field; 404 for an unknown endpoint.

Details

Measured

Limits

• 1,000 requests per hour per key, 100 per minute in bursts; ask us for more.
• Years 2020 to 2030.
• Fetch a year at a time rather than many small windows.

Data handling

Nothing personal is sent or kept. The service is GDPR and PDPA compliant.