Calls: {root}/{version}/user


POST/v4/create
Route {root}/v4/user/create
Request type BODY
User level SUPER USER
Requires authentication Yes
Response type Single

Parameters

Nested object(s)[]

Sample cURL

curl --location --request POST "{{ROOT}}/v4/user/create/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"staff_code": "sample","title": "sample","first_name": "sample","middle_name": "sample","last_name": "sample","user_type_id": "100","default_view_type_id": "1","default_view_id": "123456","default_sorting_id": "0","department_id": "123456","region_id": "123456","approver_id": "123456","approver_role_id": "0","notifier_2_id": "123456","notifier_2_role_id": "0","notifier_3_id": "123456","notifier_3_role_id": "0","email_contact": "sample","password": "sample","email_type_id": "0","allowance_type_id": "0","status_id": "0","work_telephone": "sample","mobile_telephone": "sample","active_directory_username": "sample","allowances": [{"start_date":,"opening":,"remaining":},{"start_date":,"opening":,"remaining":}]}'

Sample response

[
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_small",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_large",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"forceMFA",
"type":"Boolean",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
POST/v4/retrieve
Route {root}/v4/user/retrieve
Request type BODY
User level STAFF
Requires authentication Yes
Response type Array()

Parameters

Sample cURL

curl --location --request POST "{{ROOT}}/v4/user/retrieve/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"map_type_id": "0","map_id": "123456","last_name": "sample","status_id": "0"}'

Sample response

[
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"status_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"disabled",
"value":"0"
},
{
"name":"active",
"value":"1"
}]
"note":
},
{
"object_name":"staff_code",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"title",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"email_contact",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"email_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"text",
"value":"1"
},
{
"name":"html",
"value":"2"
}]
"note":
},
{
"object_name":"approver_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"staff",
"value":"100"
},
{
"name":"approver",
"value":"200"
},
{
"name":"approver plus add",
"value":"210"
},
{
"name":"approver plus add edit cancel",
"value":"220"
},
{
"name":"super user",
"value":"300"
},
{
"name":"super user with staff hub",
"value":"310"
}]
"note":
},
{
"object_name":"notifier_2_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"allowance_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"days",
"value":"0"
},
{
"name":"hours",
"value":"1"
}]
"note":
},
{
"object_name":"this_year_remaining",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"next_year_remaining",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
POST/v4.1/retrieve
Route {root}/v4.1/user/retrieve
Request type BODY
User level STAFF
Requires authentication Yes
Response type Array()

Parameters

Sample cURL

curl --location --request POST "{{ROOT}}/v4.1/user/retrieve/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"map_type_id": "0","map_id": "123456","last_name": "sample","status_id": "0"}'

Sample response

[
{
"object_name":"approver_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"notifier_2_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"notifier_2_first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_2_last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"notifier_3_first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_small",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_large",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"status_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"disabled",
"value":"0"
},
{
"name":"active",
"value":"1"
}]
"note":
},
{
"object_name":"staff_code",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"title",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"email_contact",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"email_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"text",
"value":"1"
},
{
"name":"html",
"value":"2"
}]
"note":
},
{
"object_name":"approver_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"staff",
"value":"100"
},
{
"name":"approver",
"value":"200"
},
{
"name":"approver plus add",
"value":"210"
},
{
"name":"approver plus add edit cancel",
"value":"220"
},
{
"name":"super user",
"value":"300"
},
{
"name":"super user with staff hub",
"value":"310"
}]
"note":
},
{
"object_name":"notifier_2_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"allowance_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"days",
"value":"0"
},
{
"name":"hours",
"value":"1"
}]
"note":
},
{
"object_name":"this_year_remaining",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"next_year_remaining",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
GET/v4/get-by-id
Route {root}/v4/user/get-by-id
Request type URL
User level STAFF
Requires authentication Yes
Response type Single
Sample call{root}/v0/user/get-by-id/12345678

Parameters

Sample cURL

curl --location --request GET "{{ROOT}}/v4/user/get-by-id/12345678-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

[
{
"object_name":"user_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"status_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"disabled",
"value":"0"
},
{
"name":"active",
"value":"1"
}]
"note":
},
{
"object_name":"staff_code",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"title",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"middle_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"staff",
"value":"100"
},
{
"name":"approver",
"value":"200"
},
{
"name":"approver plus add",
"value":"210"
},
{
"name":"approver plus add edit cancel",
"value":"220"
},
{
"name":"super user",
"value":"300"
},
{
"name":"super user with staff hub",
"value":"310"
}]
"note":
},
{
"object_name":"default_view_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"department",
"value":"1"
},
{
"name":"tag",
"value":"2"
}]
"note":
},
{
"object_name":"default_view_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"default_sorting_id",
"type":"[Byte]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"email_contact",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_2_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_2_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"notifier_3_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"email_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"text",
"value":"1"
},
{
"name":"html",
"value":"2"
}]
"note":
},
{
"object_name":"allowance_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"days",
"value":"0"
},
{
"name":"hours",
"value":"1"
}]
"note":
},
{
"object_name":"active_directory_username",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"employment_started_date",
"type":"Date",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"employment_ended_date",
"type":"Date",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"work_telephone",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"mobile_telephone",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_logins",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"login_date",
"type":"DateTime",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"device",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"image_url_small",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_large",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"google_unique_id",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"mfa_method_id",
"type":"Int16",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"password_policy",
"type":"Boolean",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"lockout_date",
"type":"DateTime",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
GET/v4/get-my-details
Route {root}/v4/user/get-my-details
Request type URL
User level STAFF
Requires authentication Yes
Response type Single
Sample call{root}/v0/user/get-my-details

Sample cURL

curl --location --request GET "{{ROOT}}/v4/user/get-my-details/-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

[
{
"object_name":"user_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"status_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"disabled",
"value":"0"
},
{
"name":"active",
"value":"1"
}]
"note":
},
{
"object_name":"staff_code",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"title",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"middle_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"staff",
"value":"100"
},
{
"name":"approver",
"value":"200"
},
{
"name":"approver plus add",
"value":"210"
},
{
"name":"approver plus add edit cancel",
"value":"220"
},
{
"name":"super user",
"value":"300"
},
{
"name":"super user with staff hub",
"value":"310"
}]
"note":
},
{
"object_name":"default_view_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"department",
"value":"1"
},
{
"name":"tag",
"value":"2"
}]
"note":
},
{
"object_name":"default_view_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"default_sorting_id",
"type":"[Byte]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"department_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"region_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"approver_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"email_contact",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_2_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_2_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"notifier_3_id",
"type":"[Int32]",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"notifier_3_role_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]
"note":
},
{
"object_name":"email_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"none",
"value":"0"
},
{
"name":"text",
"value":"1"
},
{
"name":"html",
"value":"2"
}]
"note":
},
{
"object_name":"allowance_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"days",
"value":"0"
},
{
"name":"hours",
"value":"1"
}]
"note":
},
{
"object_name":"active_directory_username",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"employment_started_date",
"type":"Date",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"employment_ended_date",
"type":"Date",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"work_telephone",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"mobile_telephone",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_logins",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"login_date",
"type":"DateTime",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"device",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"image_url_small",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_large",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"google_unique_id",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"mfa_method_id",
"type":"Int16",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"password_policy",
"type":"Boolean",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"lockout_date",
"type":"DateTime",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
PUT/v4/update
Route {root}/v4/user/update
Request type BODY
User level STAFF
Requires authentication Yes
Response type Single

Parameters

Sample cURL

curl --location --request PUT "{{ROOT}}/v4/user/update/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"user_id": "123456","staff_code": "sample","title": "sample","first_name": "sample","middle_name": "sample","last_name": "sample","user_type_id": "100","default_view_type_id": "1","default_view_id": "123456","default_sorting_id": "0","department_id": "123456","region_id": "123456","approver_id": "123456","approver_role_id": "0","notifier_2_id": "123456","notifier_2_role_id": "0","notifier_3_id": "123456","notifier_3_role_id": "0","email_contact": "sample","password": "sample","email_type_id": "0","status_id": "0","work_telephone": "sample","mobile_telephone": "sample","active_directory_username": "sample"}'

Sample response

[
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_small",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"image_url_large",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"forceMFA",
"type":"Boolean",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
DELETE/v4/del
Route {root}/v4/user/del
Request type URL
User level SUPER USER
Requires authentication Yes
Response type Single
Sample call{root}/v0/user/del/12345678

Parameters

Sample cURL

curl --location --request DELETE "{{ROOT}}/v4/user/del/12345678-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

Standard response object returned, see API Overview for structure.
POST/v4/unlock
Route {root}/v4/user/unlock
Request type URL
User level SUPER USER
Requires authentication Yes
Response type Single
Sample call{root}/v0/user/unlock/12345678

Parameters

Sample cURL

curl --location --request POST "{{ROOT}}/v4/user/unlock/12345678-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

Standard response object returned, see API Overview for structure.
GET/v4/get-approvers
Route {root}/v4/user/get-approvers
Request type URL
User level SUPER USER
Requires authentication Yes
Response type Array()
Sample call{root}/v0/user/get-approvers

Sample cURL

curl --location --request GET "{{ROOT}}/v4/user/get-approvers/-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

[
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
},
{
"object_name":"user_type_id",
"type":"custom",
"is_nullable":false,
"nest":null,
"custom":[
{
"name":"staff",
"value":"100"
},
{
"name":"approver",
"value":"200"
},
{
"name":"approver plus add",
"value":"210"
},
{
"name":"approver plus add edit cancel",
"value":"220"
},
{
"name":"super user",
"value":"300"
},
{
"name":"super user with staff hub",
"value":"310"
}]
"note":
},
{
"object_name":"email_contact",
"type":"String",
"is_nullable":false,
"nest":null,
"custom":null
"note":
}
]
POST/v4/my-staff
Route {root}/v4/user/my-staff
Request type BODY
User level APPROVER
Requires authentication Yes
Response type Single

Parameters

Sample cURL

curl --location --request POST "{{ROOT}}/v4/user/my-staff/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"staff_filter": "0"}'

Sample response

[
{
"object_name":"staff_overview",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"user_id",
"type":"Int32",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"pending_request",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"pending_overtime",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"allowance_type_id_this_year",
"type":"[Byte]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"opening_this_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"remaining_this_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"pending_this_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_opening_this_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_remaining_this_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_expiry_date_this_year",
"type":"Date",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"allowance_type_id_next_year",
"type":"[Byte]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"opening_next_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"remaining_next_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"pending_next_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_opening_next_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_remaining_next_year",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"carryover_expiry_date_next_year",
"type":"Date",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"approver_role_id",
"type":"custom",
"is_nullable":False,
"nest":null,
"custom":"[
{
"name":"none",
"value":"0"
},
{
"name":"approver both",
"value":"1"
},
{
"name":"approver leave only",
"value":"2"
},
{
"name":"approver overtime only",
"value":"3"
},
{
"name":"notifier both",
"value":"4"
},
{
"name":"notifier leave only",
"value":"5"
},
{
"name":"notifier overtime only",
"value":"6"
}]"
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"overview",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"staff_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"staff_with_leave_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"absence_record_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_popular_leave_type_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_popular_leave_type_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_days_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_days_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_days_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_hours_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_hours_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_accumulated_hours_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_days_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_days_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_days_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_hours_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_hours_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"longest_absence_hours_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"leave_type_overview",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"code",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"colour",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"occurrences_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_total",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_occurrences_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_days_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_days_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_days_duration",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_hours_first_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_hours_last_name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"most_hours_duration",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"breakdown_by_leave_type",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"occurrences",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"name",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"colour",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
},
{
"object_name":"occurrences_by_duration",
"type":"NESTED",
"is_nullable":false,
"nest":[
{
"object_name":"time_span",
"type":"String",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"occurrences",
"type":"[Int32]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
},
{
"object_name":"order_by",
"type":"[Byte]",
"is_nullable":False,
"nest":null,
"custom":null
"note":"",
}],
"custom":null
"note":
}
]


Don't have a WhosOff account yet?

Instantly reduce time spent on leave management with your FREE, no obligation trial today!
Sign up today and get until Sunday, 26th July 2026 to try the full service, for Free!

Get your instant FREE account today