Order Detail

Retrieve a single ITAD order by order number.

GET

/api/v1/itad/orders/{order_number}

Description

Returns the full ITAD order: contact, shipping/billing addresses, devices, documents, shipments, amounts, and payout status. Same schema as one orders[] row from Order List. Campaign/recovery buyback orders are not returned.

Request

Headers

Header	Value	Required
Authorization	Bearer <access_token>	Yes
Content-Type	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
order_number	string	Yes	Numeric order number from Order List or Place Order (digits only). Must belong to your company.

Response

Field	Type	Description
order_id	string	ITAD order ID, externally encoded as {7-digit-prefix}-{numericId}. Prefer order_number for Cancel and Detail lookup.
order_number	string	Unique ITAD order number. Use this for Order Detail and Cancel.
contact	object	Person attributed on the order (company default platform user).
contact.first_name	string	Contact first name.
contact.last_name	string	Contact last name.
contact.email	string	Contact email.
contact.phone	string	Contact phone.
shipping	object	Ship-from / recovery address.
shipping.email	string	Shipping email.
shipping.name	string	Shipping name.
shipping.phone	string	Shipping phone.
shipping.apt	string	Apartment / suite.
shipping.country	string	Shipping country code.
shipping.state	string	Shipping state / province.
shipping.city	string	Shipping city.
shipping.zip	string	Shipping postal code.
shipping.address	string	Shipping street address.
billing	object	Billing address from the company record.
billing.name	string	Billing name.
billing.phone	string	Billing phone.
billing.apt	string	Billing apartment / suite.
billing.address	string	Billing street address.
billing.city	string	Billing city.
billing.state	string	Billing state / province.
billing.zip	string	Billing postal code.
billing.country	string	Billing country code.
currency_code	string	Order currency (e.g. USD).
tax_amount	string \| number	Tax amount.
total_amount	string \| number	Final order total.
payout_status	string	Payout state: Paid or Unpaid (matches Manage Orders Payout column).
order_status	string	Current status label in UPPERCASE. One of: ORDER RECEIVED, BOX SHIPPED, PICKUP REQUESTED, DEVICE RECEIVED, TECHNICAL ASSESSMENT, ORDER PAYOUT, COMPLETED, CANCELLED. Manage Orders shows the same labels in Title Case.
order_status_date	string	Formatted date of the current order_status (not the same as created_at).
created_at	string	Formatted order creation date.
devices	array	Devices on the order.
devices[].device_type	number	Device category code: 1=Mobile, 2=Tablet, 3=iPod, 4=Laptop, 5=Server, 6=Printers, 7=Desktop, 8=Network Gear, 9=Other.
devices[].brand	string	Device brand.
devices[].device	string	Device category label (e.g. Laptop).
devices[].type	string	Model / type name (e.g. MacBook Pro).
devices[].qty	number	Quantity.
devices[].sub_total	string	Line subtotal.
devices[].year_manufactured	string \| null	Manufacture year when applicable (e.g. laptops).
documents	object	Attached documents keyed by document type. Each value is an array of { filename } download URLs. Empty object {} when none.
shipments	array	Carrier shipment tracking entries (empty when none).
shipments[].carrier_name	string	Carrier (e.g. ups, eshipz).
shipments[].forward	object	Outbound / forward leg tracking.
shipments[].forward.tracking_number	string \| null	Forward tracking number.
shipments[].forward.tracking_link	string \| null	Forward tracking URL.
shipments[].return	object	Return leg tracking.
shipments[].return.tracking_number	string \| null	Return tracking number.
shipments[].return.tracking_link	string \| null	Return tracking URL.

Notes

Response matches a single orders[] object from Order List, retrieved by order_number.
Use order_number from Place Order or Order List for Detail and Cancel.
devices[] lists devices on the order. device_type is a numeric category code (1–9).
contact is the attributed platform user; shipping is the ship-from / recovery address.
documents is always an object keyed by document type → array of { filename } URLs ({} when none).
shipments[] holds carrier tracking with forward and return legs. For print-a-label recoveries, tracking often appears under return.
order_status is always an UPPERCASE string. Valid values: ORDER RECEIVED, BOX SHIPPED, PICKUP REQUESTED, DEVICE RECEIVED, TECHNICAL ASSESSMENT, ORDER PAYOUT, COMPLETED, CANCELLED.
payout_status is Paid or Unpaid (Manage Orders Payout column).
404 when the order number does not exist, belongs to another company, or is a campaign/recovery order excluded from ITAD.

Related Endpoints

Order List

Browse all ITAD orders

Place Order

Create an ITAD order

Cancel Order

Cancel an ITAD order by order_number

Did this page help you?

Request

curl -X GET https://dev-api.unduit.com/api/v1/itad/orders/174894512345 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Success Response

{
  "order_id": "4829103-12345",
  "order_number": "174894512345",
  "contact": {
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "5551234567"
  },
  "shipping": {
    "email": "[email protected]",
    "name": "Acme Corp IT",
    "phone": "5551234567",
    "apt": "Suite 200",
    "country": "US",
    "state": "CA",
    "city": "San Jose",
    "zip": "95110",
    "address": "500 Logistics Way"
  },
  "billing": {
    "name": "Acme Corporation",
    "phone": "5551234567",
    "apt": "",
    "address": "100 Corporate Blvd",
    "city": "San Jose",
    "state": "CA",
    "zip": "95110",
    "country": "US"
  },
  "currency_code": "USD",
  "tax_amount": "0.00",
  "total_amount": "0.00",
  "payout_status": "Unpaid",
  "order_status": "ORDER RECEIVED",
  "order_status_date": "Jun 3rd, 2026",
  "created_at": "Jun 3rd, 2026",
  "devices": [
    {
      "device_type": 4,
      "brand": "Apple",
      "device": "Laptop",
      "type": "MacBook Pro",
      "qty": 2,
      "sub_total": 0,
      "year_manufactured": "2024"
    }
  ],
  "documents": {
    "Certificate of Destruction": [
      {
        "filename": "https://dev-api.unduit.com/download-my-file?path=storage/app/public/buyback_document/&filename=cert.pdf&is_encrypted=1"
      }
    ]
  },
  "shipments": [
    {
      "carrier_name": "ups",
      "forward": {
        "tracking_number": null,
        "tracking_link": null
      },
      "return": {
        "tracking_number": "1Z999AA10123456784",
        "tracking_link": "https://wwwapps.ups.com/WebTracking/processRequest?HTMLVersion=5.0&Requester=NES&loc=en_US&tracknum=1Z999AA10123456784"
      }
    }
  ]
}

Error Responses

404 Order not found

{
  "success": false,
  "message": "Order not found"
}