Humatrix API
API Search Card
Used to search for employees or check employee information with ID Card or specify the name of the employee. For employee information of your company.
If you’re using the API for a single account, the ID Card authentication flow is an easier way to get set up. You can authenticate via the command line using your Humatrix login details, or you can just set up an access token through the Humatrix APImanagement page.
1. Make a GET request to the token endpoint
The response should look something like this:
In the case of searching by the employees ID card.
[
{
"nation_id": "1100800086799",
"gender": "None",
"birthdate": "2020-01-01",
"title_th": "None",
"title_en": "None",
"firstname_th": "None",
"firstname_en": "None",
"lastname_th": "None",
"lastname_en": "None",
"address": "None",
"address_no": "None",
"address_village": "None",
"address_lane": "None",
"address_road": "None",
"address_tambon": "None",
"address_amphur": "None",
"address_province": "None",
"issue": "2020-01-01",
"expire": "2020-01-01",
"create_date": "2020-05-19T16:49:25.040",
"update_date": "2020-05-19T16:49:25.040"
}
]
In the case of searching by the name of the employee.
[
{
"nation_id": "1234567890123",
"gender": "หญิง",
"birthdate": "1997-02-08",
"title_th": "น.ส.",
"title_en": "Miss",
"firstname_th": "นภา",
"firstname_en": "Napa",
"lastname_th": "สีใส",
"lastname_en": "Seesai",
"address": "17 แขวงหนองแขม เขตหนองแขม จังหวัดกรุงเทพมหานคร ",
"address_no": "17",
"address_village": "",
"address_lane": "",
"address_road": "",
"address_tambon": "แขวงหนองแขม",
"address_amphur": "เขตหนองแขม",
"address_province": "จังหวัดกรุงเทพมหานคร",
"issue": "2018-05-03",
"expire": "2027-02-03",
"create_date": "2020-05-20T13:32:23.274",
"update_date": "2020-05-20T13:32:23.274"
},
{
"nation_id": "2345678901234",
"gender": "หญิง",
"birthdate": "1996-04-04",
"title_th": "น.ส.",
"title_en": "Miss",
"firstname_th": "นภา",
"firstname_en": "Napa",
"lastname_th": "สุดใจ",
"lastname_en": "Soodjai",
"address": "18 แขวงบางแค เขตบางแค จังหวัดกรุงเทพมหานคร ",
"address_no": "17",
"address_village": "",
"address_lane": "",
"address_road": " ",
"address_tambon": "เขตบางแค",
"address_amphur": "แขวงบางแค",
"address_province": "จังหวัดกรุงเทพมหานคร",
"issue": "2015-05-03",
"expire": "2024-02-03",
"create_date": "2020-05-20T13:32:23.274",
"update_date": "2020-05-20T13:32:23.274"
}
]
Scopes
In both the
Authorization Code
,
Password
you must specify the
Scopes
This is a complete scope list in the Humatrix API. In addition, each destination specifies the scope to use.
| Scopes | Endpoints | Description |
|---|---|---|
read ,
write ,
group
|
Users | Access information about the current user. |
report
|
Users,Document | Manage document updates and shift document status. |
Note :
Scope default
read ,
write