Recovery Items
List devices and items for a recovery by recovery number.
GET
/api/v1/recoveries/{recovery_number}/itemsDescription
Returns recovery employee contact/address details and up to five devices in an items array (only populated slots are included).
status is the overall Recover workflow label (e.g. Order Received, Boxes Shipped, Delivered, Return Shipped, Box Received). Each item includes item_status for per-device intake processing.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| recovery_number | string | Yes | Recovery code (recovery_code on the campaign employee). |
Response
| Field | Type | Description |
|---|---|---|
| data | object | Recovery items payload. |
| data.recovery_number | string | Recovery code. |
| data.status | string | Overall recovery workflow status. Examples: Order Received, Print Shipping Label, Boxes Shipped, Delivered, Label Requested, Label Delivered, Pickup Requested, Pickup Scheduled, Return Shipped, Box Received, Already Returned, Cancelled, Not Responsive, Recovery Failed, Recovery Order, Delivery Failed. |
| data.email | string | Employee email. |
| data.firstname | string | Employee first name. |
| data.lastname | string | Employee last name. |
| data.phone_country | string | Phone country code. |
| data.phone | string | Phone number. |
| data.address_line_1 | string | Address line 1. |
| data.address_line_2 | string | Address line 2. |
| data.city | string | City. |
| data.state | string | State. |
| data.zip | string | Postal code. |
| data.country | string | Country code. |
| data.items | array | Devices for this recovery (max 5 slots). |
| data.items[].slot | number | Item slot number (1–5). |
| data.items[].name | string | Device or item name. |
| data.items[].serial_no | string | Serial number. |
| data.items[].asset_id | string | Customer asset ID. |
| data.items[].imei | string | IMEI (mobile devices). |
| data.items[].device_type | string | number | Device type label or code as stored on the recovery record. |
| data.items[].item_status | string | Per-item intake status from asset receipts (defaults to Pending when not yet received). |
Related Endpoints
Did this page help you?
Request
curl -X GET https://uat.unduit.com/api-exposed/api/v1/recoveries/REC-2026-001/items \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"Success Response
{
"data": {
"recovery_number": "REC-2026-001",
"status": "Box Received",
"email": "employee@example.com",
"firstname": "Alex",
"lastname": "Johnson",
"phone_country": "+1",
"phone": "5551234567",
"address_line_1": "100 Main St",
"address_line_2": "",
"city": "Austin",
"state": "TX",
"zip": "78701",
"country": "US",
"items": [
{
"slot": 1,
"name": "MacBook Pro",
"serial_no": "C02XK1ABCDEF",
"asset_id": "AST-1001",
"imei": null,
"device_type": "Laptop",
"item_status": "Received"
},
{
"slot": 2,
"name": "iPhone 15",
"serial_no": "F2LD9X8KPFWD",
"asset_id": "AST-1002",
"imei": "356938035643809",
"device_type": "Smartphone",
"item_status": "Pending"
}
]
}
}Error Responses
404 Not Found
{
"message": "Recovery not found"
}