Recovery Items

List devices and items for a recovery by recovery number.

GET

/api/v1/recoveries/{recovery_number}/items

Description

Returns recovery employee profile plus up to five item slots (item_1 … item_5) with serial numbers, asset IDs, and device types.

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

Related Endpoints

Recovery Status

Get recovery workflow status

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",
    "employee_id": 8842,
    "status": "Device 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",
    "item_1": "MacBook Pro",
    "item_1_serial_no": "C02XK1ABCDEF",
    "item_1_asset_id": "AST-1001",
    "item_1_imei": null,
    "item_1_device_type": "Laptop",
    "item_2": null,
    "item_2_serial_no": null
  }
}

Error Responses

404 Not Found

{
  "message": "Recovery not found"
}