Get Company Holidays

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

Endpoint


GET /api/v1/open-apis/salary/get-data-filter?path_action=get_company_holidays

Request Parameters

Parameter	Type	Required	Description	Example
`year`	string	Yes	ปีที่ต้องการดู (YYYY)	`"2026"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "holiday_id": "20260101HOLIDAY001",
      "holiday_code": "NY2026",
      "holiday_dt": "2026-01-01",
      "holiday_name": "วันขึ้นปีใหม่",
      "holiday_name_en": "New Year's Day",
      "year": "2026"
    },
    {
      "holiday_id": "20260413HOLIDAY001",
      "holiday_code": "SK2026",
      "holiday_dt": "2026-04-13",
      "holiday_name": "วันสงกรานต์",
      "holiday_name_en": "Songkran Festival",
      "year": "2026"
    },
    {
      "holiday_id": "20260501HOLIDAY001",
      "holiday_code": "LD2026",
      "holiday_dt": "2026-05-01",
      "holiday_name": "วันแรงงานแห่งชาติ",
      "holiday_name_en": "Labour Day",
      "year": "2026"
    }
  ]
}

Response Fields

Field	Type	Nullable	Description
`holiday_id`	string	No	รหัสวันหยุด (20 ตัวอักษร)
`holiday_code`	string	Yes	รหัสย่อวันหยุด (เช่น NY2026, SK2026)
`holiday_dt`	string	No	วันที่หยุด (YYYY-MM-DD)
`holiday_name`	string	No	ชื่อวันหยุด (ภาษาไทย)
`holiday_name_en`	string	Yes	ชื่อวันหยุด (ภาษาอังกฤษ)
`year`	string	No	ปี (YYYY)

Error Responses

Missing Required Parameter (400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "year": "year is required"
  }
}

Invalid Year Format (400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "year": "Invalid format. Expected YYYY"
  }
}

Code Examples

cURL


# ดูวันหยุดบริษัทปี 2026 (ภาษาไทย)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_company_holidays&year=2026&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# ดูวันหยุดบริษัทปี 2026 (ภาษาอังกฤษ)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_company_holidays&year=2026&language_code=EN" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_company_holidays',
  year: '2026',
  language_code: 'TH'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
data.payload.forEach(holiday => {
  console.log(`${holiday.holiday_dt}: ${holiday.holiday_name}`)
})

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "get_company_holidays", "year": "2026", "language_code": "TH"}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for holiday in data["payload"]:
    print(f"{holiday['holiday_dt']}: {holiday['holiday_name']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_company_holidays",
    "year" => "2026",
    "language_code" => "TH"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
foreach ($data["payload"] as $holiday) {
    echo "{$holiday['holiday_dt']}: {$holiday['holiday_name']}\n";
}
?>

Notes

วันหยุดที่แสดงรวมถึง: วันหยุดนักขัตฤกษ์ วันหยุดพิเศษของบริษัท และวันหยุดชดเชย
รายการวันหยุดเรียงลำดับตามวันที่ (holiday_dt) จากน้อยไปมาก
ข้อมูลวันหยุดบริษัทเป็นข้อมูลตามปี แนะนำให้ทำ cache ข้อมูลทั้งปีและ refresh เมื่อมีการเปลี่ยนแปลง

parameter year เป็นค่าที่จำเป็นต้องระบุ หากไม่ส่งจะได้รับ error 400 และต้องส่งในรูปแบบ YYYY (4 หลัก) เท่านั้น

Get Holiday Types - ดึงรายการประเภทวันหยุด
Get Work Shifts - ดึงรายการกะการทำงาน
Get Extra Holiday Quota - ดึงโควตาวันหยุดพิเศษ
Get Calendar Month - ดูปฏิทินทั้งเดือนพร้อมวันหยุด