Get agent work status change history
POST https://api.usedesk.com/user/status/history
Note: If you are using the on-premise version of Usedesk on your own server, the API method URL may differ. Please check the correct API URL with support at support@usedesk.com.
This method allows you to retrieve the history of work status changes for a specific agent within a selected time period.
* — required parameters
| Parameter | Description |
| api_token* | Channel API token |
| user_id* | Agent ID |
| after* | Filter by date and time of status change Only status changes that occurred after the specified date will be returned. Example: "after": "2026-02-16 01:00" Important: The API uses UTC+0 and does not depend on your company’s working hours. Please take this into account when setting the filter. |
| before* | Filter by date and time of status change Only status changes that occurred before the specified date will be returned.
Example:
"before": "2026-02-16 15:00"
Important: The API uses UTC+0 and does not depend on your company’s working hours. Please take this into account when setting the filter.
|
Request example
{
"api_token": "1111abc",
"user_id": "65378",
"after": "2026-02-16 01:00",
"before": "2026-02-16 15:00"
}
Response example
{
"text": "Online (Tickets)",
"date": "2026-02-16 09:02:51"
}
Response parameters
| Parameter | Description |
| text | The applied work status (Online/Offline) with the system section specified (Tickets/Chat) |
| date | Date and time of the status change (UTC) |