Thai Holiday Data API

ดึงข้อมูลวันหยุดนักขัตฤกษ์และวันหยุดสถาบันการเงินของไทย ตามปี ตามช่วงวันที่ หรือช่วงรอบวันนี้ พร้อมวันที่ วันในสัปดาห์ และชื่อวันหยุด

GET/v3/store/data/thai-holiday

และอีก 1 endpoint

ทดลองใช้

• ราคา0.1 ICต่อครั้ง
• รองรับ1000 ครั้ง/ชั่วโมง
• ให้บริการแล้ว58Kครั้ง

• v1.0
• ใช้งานได้

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

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /range ดูที่ 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 ฟิลด์อธิบายไว้ในหัวข้อ 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 พร้อม query parameter คิด 0.1 IC ต่อครั้งทุก endpoint

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

holiday_typestring

public (ค่าเริ่มต้น) financial หรือ both

days_beforedays_afterinteger

จำนวนวันก่อนและหลังวันนี้ แต่ละค่าไม่เกิน 1,825 ค่าเริ่มต้น 0 และ 365

yearinteger

ปี ค.ศ. 2020 ถึง 2030 ใช้แทนช่วงรอบวันนี้

start_dateend_datestring

สำหรับ /range: YYYY-MM-DD ต้องใส่ทั้งคู่

Endpoint	ส่งกลับ
/v3/store/data/thai-holiday	วันหยุดในช่วงที่ขอ หรือทั้งปีตาม year
/v3/store/data/thai-holiday/year/{year}	ทั้งปี
/v3/store/data/thai-holiday/range	วันหยุดระหว่างสองวันที่
/v3/store/data/thai-holiday/types	ประเภทวันหยุด

path เดิม /data/thai-holidays/holidays ยังใช้ได้ในราคาเดียวกัน

Response

ตามแผงด้านข้าง: holidays[] แต่ละรายการมี date, weekday, name, type (public หรือ financial) และ date_thai, weekday_thai, name_thai เมื่อมีข้อมูล ตามด้วย total_count, date_range ที่ระบบตีความจาก query และ cached_at

ตามแผงด้านข้าง: holidays[] แต่ละรายการมี date, weekday, name, type (public หรือ financial) และ date_thai, weekday_thai, name_thai เมื่อมีข้อมูล ตามด้วย total_count, date_range ที่ระบบตีความจาก query และ cached_at

รหัสสถานะ

400 และ 422 เมื่อ parameter ไม่ถูกต้อง เช่น วันที่ไม่อยู่ในรูป YYYY-MM-DD หรือ holiday_type ไม่ใช่หนึ่งในสามค่า โดย detail[] บอกชื่อฟิลด์ และ 404 เมื่อเรียก endpoint ที่ไม่มีอยู่

รายละเอียดเพิ่มเติม

ผลการทดสอบ

ข้อจำกัด

• 1,000 ครั้งต่อชั่วโมงต่อ API key และไม่เกิน 100 ครั้งต่อนาทีในช่วงสั้น ๆ ต้องการมากกว่านี้แจ้งเราได้
• ปี ค.ศ. 2020 ถึง 2030
• ดึงทีละทั้งปีดีกว่าเรียกช่วงสั้น ๆ หลายครั้ง

การจัดการข้อมูล

ไม่มีการส่งหรือเก็บข้อมูลส่วนบุคคล