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.firstname | string | Employee first name. |
| data.lastname | string | Employee last name. |
| data.send_notifications_to | string | Where recovery email and SMS updates are sent: work or personal. |
| data.work_email | string | Employee work email address. |
| data.personal_email | string | Employee personal email address. |
| data.work_phone | string | Employee work phone number. |
| data.personal_phone | string | Employee personal phone number. |
| data.work_phone_country | string | ISO country code for the work phone. |
| data.personal_phone_country | string | ISO country code for the personal phone. |
| data.email | string | Legacy alias of work_email. Same value. Prefer work_email. |
| data.phone | string | Legacy alias of work_phone. Same value. Prefer work_phone. |
| data.phone_country | string | Legacy alias of work_phone_country. Same value. Prefer work_phone_country. |
| 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://dev-api.unduit.com/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",
"firstname": "Alex",
"lastname": "Johnson",
"send_notifications_to": "work",
"work_email": "[email protected]",
"personal_email": null,
"work_phone": "5551234567",
"personal_phone": null,
"work_phone_country": "US",
"personal_phone_country": null,
"email": "[email protected]",
"phone": "5551234567",
"phone_country": "US",
"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"
}