Chain of Custody List
List device-level chain of custody records for your company.
GET
/api/v1/chain-of-custodyDescription
Returns the same device-row custody list shown in the Unduit platform Chain of Custody table (repair, ITAD, and remote recovery rows merged). Matches platform list filters: search by IMEI or serial, plus pagination. No date or order-type filters (a device may appear on multiple orders; use the timeline endpoint for order-level history). Sorted newest first by order created_at, with repair rows before ITAD/recovery on timestamp ties. Requires permission chain-of-custody.read.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number (1-based). Default is 1. |
| limit | number | No | Records per page. Default is 10. Max 100 on tickets, wallet, and shipping labels. |
| search | string | No | Filter by partial IMEI or serial number match (same as platform search). |
Response
| Field | Type | Description |
|---|---|---|
| data | array | Device-level custody records. |
| data[].serial | string | Device serial number. |
| data[].imei | string | Device IMEI. |
| data[].model | string | Device model name (platform column Model / d_model). |
| data[].memory | string | Memory / storage size when available. |
| data[].color | string | Device color when available. |
| data[].mdm_status | string | MDM status when available. |
| data[].notes | string | Device notes when available. |
| data[].esn | string | ESN when available. |
| data[].failed | string | Failed flag when available. |
| data[].erased | string | Erasure flag when available. |
| pagination.page | integer | Current page. |
| pagination.limit | integer | Page size. |
| pagination.total | integer | Total matching records. |
| pagination.last_page | integer | Last available page. |
Related Endpoints
Did this page help you?
Request
curl -X GET https://uat.unduit.com/api-exposed/api/v1/chain-of-custody \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"Success Response
{
"data": [
{
"serial": "C02XK1ABCDEF",
"imei": "356938035643809",
"model": "iPhone 13",
"memory": "128GB",
"color": "Midnight",
"mdm_status": "Off",
"notes": null,
"esn": null,
"failed": "No",
"erased": "Yes"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 42,
"last_page": 5
}
}Error Responses
401 Unauthorized
{
"message": "Access denied: No token provided."
}