Get Leave List

ดึงรายการคำขอลาตามเงื่อนไขที่กำหนด พร้อมรองรับการ filter และ pagination

ใช้ API นี้เพื่อดึงรายการคำขอลา ติดตามสถานะการอนุมัติ หรือสร้างรายงานสรุป

Endpoint


GET /api/v1/open-apis/time-leave/get-list

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`start_date`	string	Yes	วันที่เริ่มต้น (YYYY-MM-DD)	`2026-01-01`
`end_date`	string	Yes	วันที่สิ้นสุด (YYYY-MM-DD)	`2026-01-31`

Optional Parameters

Parameter	Type	Required	Description	Example
`approve_flag`	string	No	สถานะการอนุมัติ (`01`, `02`, `03`)	`01`
`absence_flag_lv`	string	No	ประเภทการลา (`absence-01` หรือ `01`)	`absence-01`
`keyword`	string	No	คำค้นหา (ชื่อ, รหัสพนักงาน)	`สมชาย`
`branch_id`	string	No	ID สาขา	`QlIwMDE=`
`department_id`	string	No	ID แผนก	`REVQMDE=`
`sort_by`	string	No	เรียงตาม field	`effective_hour`
`sort_order`	string	No	ลำดับการเรียง (`ASC`, `DESC`)	`DESC`
`_PAGE`	number	No	หน้าที่ต้องการ	`1`
`_NUMBER_PER_PAGE`	number	No	จำนวนรายการต่อหน้า (1-1000)	`20`

Approve Flag Values

Value	Status	Description
`01`	Pending	รออนุมัติทั้งหมด (รวม 04-08)
`02`	Approved	อนุมัติแล้ว
`03`	Not Approved	ไม่อนุมัติ

Sort By Options

effective_hour - เวลาเริ่มต้นการลา (default)
employee_code - รหัสพนักงาน
approve_flag - สถานะการอนุมัติ
created - วันที่สร้าง
absence_day - จำนวนวันลา

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "time_leave_id": "VExWMDAxMjM=",
      "employee_code": "EMP001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_name_en": "Somchai",
      "employee_last_name_en": "Jaidee",
      "employee_nickname_en": "Chai",
      "absence_flag_lv": "absence-01",
      "absence_flag_name": "ลาป่วย",
      "absence_flag_name_en": "Sick Leave",
      "effective_dt": "2026-01-15",
      "expire_dt": "2026-01-15",
      "effective_hour": "2026-01-15 08:00:00",
      "expire_hour": "2026-01-15 17:00:00",
      "absence_day": 1.0,
      "absence_sum_time": 8.0,
      "time_leave_desc": "ไม่สบาย มีไข้",
      "approve_flag": "01",
      "approve_status": "Pending",
      "approve_id": "QVBQMDAxMjM=",
      "approve_upd": "2026-01-13 10:30:00",
      "approve_remark": "",
      "created": "2026-01-13 09:00:00",
      "created_by": "EMP001",
      "last_upd": "2026-01-13 10:30:00",
      "last_upd_by": "EMP001"
    }
  ],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 25,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 20
  }
}

Success Response - No Data (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 0,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 0
  }
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "Missing required parameter: 'start_date'",
    "'end_date' must be in format YYYY-MM-DD"
  ]
}

Response Fields

Field	Type	Description
`time_leave_id`	string	ID ของคำขอลา
`employee_code`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน (ไทย)
`employee_last_name`	string	นามสกุลพนักงาน (ไทย)
`employee_nickname`	string	ชื่อเล่น (ไทย)
`employee_name_en`	string	ชื่อพนักงาน (อังกฤษ)
`employee_last_name_en`	string	นามสกุลพนักงาน (อังกฤษ)
`employee_nickname_en`	string	ชื่อเล่น (อังกฤษ)
`absence_flag_lv`	string	รหัสประเภทการลา
`absence_flag_name`	string	ชื่อประเภทการลา (ไทย)
`absence_flag_name_en`	string	ชื่อประเภทการลา (อังกฤษ)
`effective_dt`	string	วันที่เริ่มต้น (YYYY-MM-DD)
`expire_dt`	string	วันที่สิ้นสุด (YYYY-MM-DD)
`effective_hour`	datetime	เวลาเริ่มต้น
`expire_hour`	datetime	เวลาสิ้นสุด
`absence_day`	number	จำนวนวันลา
`absence_sum_time`	number	จำนวนชั่วโมงลารวม
`time_leave_desc`	string	รายละเอียด/เหตุผล
`approve_flag`	string	รหัสสถานะการอนุมัติ
`approve_status`	string	ชื่อสถานะการอนุมัติ
`approve_id`	string	ID ผู้อนุมัติ
`approve_upd`	datetime	วันเวลาที่อนุมัติ
`approve_remark`	string	หมายเหตุการอนุมัติ
`created`	datetime	วันเวลาที่สร้าง
`created_by`	string	ผู้สร้าง
`last_upd`	datetime	วันเวลาที่แก้ไขล่าสุด
`last_upd_by`	string	ผู้แก้ไขล่าสุด

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/get-list?start_date=2026-01-01&end_date=2026-01-31&approve_flag=01&_NUMBER_PER_PAGE=20" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  start_date: '2026-01-01',
  end_date: '2026-01-31',
  approve_flag: '01',
  _NUMBER_PER_PAGE: '20'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/get-list?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
// แสดงรายการคำขอลา
data.payload.forEach(item => {
  console.log(`${item.employee_name}: ${item.absence_flag_name} - ${item.absence_day} วัน (${item.approve_status})`)
})
 
// แสดง pagination info
console.log(`Total: ${data._PAGINATION._TOTAL_RECORDS} records`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/get-list"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "start_date": "2026-01-01",
    "end_date": "2026-01-31",
    "approve_flag": "01",
    "_NUMBER_PER_PAGE": 20
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
# แสดงรายการคำขอลา
for item in data['payload']:
    print(f"{item['employee_name']}: {item['absence_flag_name']} - {item['absence_day']} วัน ({item['approve_status']})")
 
# แสดง pagination info
print(f"Total: {data['_PAGINATION']['_TOTAL_RECORDS']} records")

PHP


<?php
$params = http_build_query([
    'start_date' => '2026-01-01',
    'end_date' => '2026-01-31',
    'approve_flag' => '01',
    '_NUMBER_PER_PAGE' => 20
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/get-list?" . $params;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
// แสดงรายการคำขอลา
foreach ($data['payload'] as $item) {
    echo "{$item['employee_name']}: {$item['absence_flag_name']} - {$item['absence_day']} วัน ({$item['approve_status']})\n";
}
 
// แสดง pagination info
echo "Total: {$data['_PAGINATION']['_TOTAL_RECORDS']} records\n";
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`start_date`	ต้องระบุและรูปแบบ YYYY-MM-DD	`Missing required parameter: 'start_date'`
`end_date`	ต้องระบุและรูปแบบ YYYY-MM-DD	`Missing required parameter: 'end_date'`
`end_date`	ต้อง >= start_date	`'end_date' must be greater than or equal to 'start_date'`
`approve_flag`	ต้องเป็น `01`, `02`, หรือ `03`	`'approve_flag' must be one of: 01, 02, 03`
`absence_flag_lv`	ต้องเป็น `01`-`08` หรือ `10`-`20`	`'absence_flag_lv' must be 01 to 08 or 10 to 20`
`_NUMBER_PER_PAGE`	ต้องเป็นตัวเลข 1-1000	`'_NUMBER_PER_PAGE' must be a number between 1 and 1000`

Notes

approve_flag = '01' จะดึงรายการที่รออนุมัติทุกระดับ (01, 04-08)
absence_flag_lv รองรับทั้งรูปแบบ absence-01 และ 01
การค้นหาจะรวมทุกวันที่ที่ช่วงการลาทับซ้อนกับช่วงที่ระบุ

Use Cases

แสดงรายการรออนุมัติ - ใช้ approve_flag=01 เพื่อดึงคำขอที่รออนุมัติ
ค้นหาตามพนักงาน - ใช้ keyword เพื่อค้นหา
รายงานประจำเดือน - ใช้ start_date และ end_date ของเดือนนั้น
Filter ตามแผนก - ใช้ department_id เพื่อกรองตามแผนก
Filter ตามประเภทการลา - ใช้ absence_flag_lv เพื่อกรองตามประเภท

Error Handling

Error	Cause	Solution
`Missing required parameter: 'start_date'`	ไม่ได้ส่ง start_date	ตรวจสอบ query parameter
`'start_date' must be in format YYYY-MM-DD`	รูปแบบวันที่ไม่ถูกต้อง	ใช้รูปแบบ YYYY-MM-DD
`'end_date' must be greater than or equal to 'start_date'`	end_date น้อยกว่า start_date	ตรวจสอบช่วงวันที่

Get Leave Types - ดึงรายการประเภทการลา
Submit Leave - ยื่นคำขอลาใหม่

Get Leave List

Endpoint

Request Parameters

Required Parameters

Optional Parameters

Approve Flag Values

Sort By Options

Response Format

Success Response (HTTP 200)

Success Response - No Data (HTTP 200)

Error Response (HTTP 400)

Response Fields

Code Examples

cURL

JavaScript

Python

PHP

Validation Rules

Notes

Use Cases

Error Handling

Related APIs