Asset History
View status changes and activity for an asset.
GET
/api/v1/assets/{id}/historyDescription
Returns a timeline of status changes and events for the asset. Use serial number, customer asset ID, internal ID, or asset number as the id.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Serial number, customer asset ID, internal ID, or asset number. |
Response
| Field | Type | Description |
|---|---|---|
| history | array | Chronological activity log (newest first). |
| history[].status | number | Status ID at time of event. |
| history[].status_update_date | string | Status update timestamp. |
| history[].old | number | Previous status ID. |
| history[].activity | string | Event type (e.g. Asset Created, Assigned, Status Changed). |
| history[].description | string | Human-readable event description. |
| history[].created_at | string | When the event was logged. |
| history[].user | object | User who triggered the event (firstname, lastname, email). |
| history[].user.firstname | string | User first name. |
| history[].user.lastname | string | User last name. |
| history[].user.email | string | User email. |
Related Endpoints
Did this page help you?
Request
curl -X GET https://uat.unduit.com/api-exposed/api/v1/assets/C02XK1ABCDEF/history \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"Success Response
{
"history": [
{
"status": 60,
"status_update_date": "2023-01-20 10:00:00",
"old": 58,
"activity": "Status Changed",
"description": "Status changed to In Use",
"created_at": "2023-01-20 10:00:00",
"user": {
"firstname": "Admin",
"lastname": "User",
"email": "admin@company.com"
}
},
{
"status": 58,
"status_update_date": null,
"old": 0,
"activity": "Asset Created",
"description": "Asset created by ",
"created_at": "2023-01-15 14:00:00",
"user": {
"firstname": "Admin",
"lastname": "User",
"email": "admin@company.com"
}
}
]
}