Place ITAD Order
Submit a new IT asset disposition (ITAD) order.
POST
/api/v1/itad/place-orderDescription
Creates an ITAD buyback order with line items and shipping address. Requires active work instruction and service provider for the ship-to country.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| items | array | Yes | Non-empty array of devices to dispose. |
| address_id | number | No | Corporate address ID for shipping. |
| shipping_email | string | No | Shipping contact email. |
| notify_order | number | No | 1 to send order notification email. |
| sname | string | No | Ship-to name (if not using address_id). |
| saddress_1 | string | No | Ship-to street line 1. |
| saddress_2 | string | No | Ship-to street line 2. |
| scity | string | No | Ship-to city. |
| sstate | string | No | Ship-to state. |
| scountry | string | No | Ship-to country code (e.g. US). |
| szip | string | No | Ship-to postal code. |
| sphone | string | No | Ship-to phone. |
Each object in items[]
Fields
| Parameter | Type | Required | Description |
|---|---|---|---|
| device_category | string | number | Yes | 1=Mobile, 2=Tablet, 3=iPod, 4=Laptop, 5=Server, 6=Printer, 7=Desktop, 8=Network, 9=Other (or name). |
| qty | number | Yes | Quantity (must be ≥ 1). |
| brand | string | No | Device brand. |
| model | string | No | Device model. |
Example Request Body
{
"items": [
{
"device_category": 4,
"qty": 2,
"brand": "Apple",
"model": "MacBook Pro"
},
{
"device_category": "phone",
"qty": 5,
"brand": "Samsung",
"model": "Galaxy S23"
}
],
"scountry": "US",
"sstate": "CA",
"scity": "San Jose",
"szip": "95110",
"saddress_1": "500 Logistics Way",
"sname": "Acme Corp IT",
"shipping_email": "it@acme.com",
"notify_order": 1
}Response
Related Endpoints
Did this page help you?
Request
curl -X POST https://uat.unduit.com/api-exposed/api/v1/itad/place-order \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"device_category": 4,
"qty": 2,
"brand": "Apple",
"model": "MacBook Pro"
},
{
"device_category": "phone",
"qty": 5,
"brand": "Samsung",
"model": "Galaxy S23"
}
],
"scountry": "US",
"sstate": "CA",
"scity": "San Jose",
"szip": "95110",
"saddress_1": "500 Logistics Way",
"sname": "Acme Corp IT",
"shipping_email": "it@acme.com",
"notify_order": 1
}'Success Response
{
"message": "Order placed successfully",
"order_number": "174894512345",
"order_id": 12345
}