Unduit

Place Order

Submit an order to get value from your old IT assets

POST
/api/v1/itad/place-order

Description

List the devices and the address where they are located. Include all required shipping fields in your request.

Optionally set recovery_option to choose how devices are recovered. When omitted or invalid, send_me_a_box is used.

The order is always created when core fields are valid. Recovery is attempted immediately after placement and depends on your region and service provider configuration.

Request

Headers

HeaderValueRequired
AuthorizationBearer <access_token>Yes
Content-Typeapplication/jsonYes

Body Parameters

ParameterTypeRequiredExampleDescription
itemsarrayYes—Non-empty array of devices to dispose.
shipping_namestringYes—Ship-from contact or company name (where devices are located).
shipping_address_1stringYes—Ship-from street address line 1.
shipping_address_2stringNo—Ship-from street address line 2.
shipping_citystringYes—Ship-from city.
shipping_statestringYes—Ship-from state or province.
shipping_countrystringYes—Ship-from country code (e.g. US).
shipping_zipstringYes—Ship-from postal code.
shipping_phonestringYes—Ship-from phone (10–15 digits).
shipping_emailstringNo—Shipping contact email.
recovery_optionstringNosend_me_a_boxHow devices should be recovered after the order is placed: send_me_a_box, print_a_label, or request_pickup. Omitted or invalid values default to send_me_a_box.

Each object in items[]

Fields

ParameterTypeRequiredDescription
device_categorystring | numberYes1=Mobile, 2=Tablet, 3=iPod, 4=Laptop, 5=Server, 6=Printer, 7=Desktop, 8=Network, 9=Other (or name).
qtynumberYesQuantity (must be ≥ 1).
brandstringYesDevice brand (e.g. Apple, Dell).
modelstringYesDevice model (e.g. MacBook Pro 14, Latitude 5520).

When recovery_option is print_a_label

Fields

ParameterTypeRequiredExampleDescription
number_of_labelsnumberYes1Number of shipping labels to generate (1–10).
weight_lbsnumberYes5Package weight in pounds. Alias: w_pound.
weight_oznumberYes0Additional package weight in ounces. Alias: w_ounce. Combined weight must be greater than 0 and not exceed 150 lbs.
length_innumberYes12Package length in inches. Alias: d_length.
width_innumberYes10Package width in inches. Alias: d_width.
height_innumberYes8Package height in inches. Alias: d_height.

When recovery_option is request_pickup

Fields

ParameterTypeRequiredExampleDescription
pickup_firstnamestringYes—Pickup contact first name. Alias: firstname.
pickup_lastnamestringYes—Pickup contact last name. Alias: lastname.
pickup_emailstringYes—Pickup contact email. Alias: email.
pickup_phonestringYes—Pickup contact phone (at least 10 digits). Alias: phone.
pickup_phone_countrystringYesUSPickup phone country (ISO alpha-2). Alias: phone_country.
pickup_address_1stringYes—Pickup street address line 1. Alias: address_1.
pickup_address_2stringNo—Pickup street address line 2. Alias: address_2.
pickup_citystringYes—Pickup city. Alias: city.
pickup_statestringYes—Pickup state or province. Alias: state.
pickup_countrystringYes—Pickup country. Alias: country.
pickup_zipstringYes—Pickup postal code (5–10 characters). Alias: zip.
pickup_datestringYes06/15/2026Requested pickup date (MM/DD/YYYY or YYYY-MM-DD).
pickup_timestringYes10:00:00Preferred pickup time (HH:MM:SS, e.g. 10:00:00).
pickup_servicestringYesinside_pickupPickup service type. Must be inside_pickup (inside pickup) or liftgate_service_pickup (liftgate services at pickup).
pickup_descriptionstringYes—Packaging details: pallets, gaylords, box counts, etc. Alias: description.
is_freight_elevatorbooleanNofalseFreight elevator available at pickup. Default false.
forklift_availablebooleanNofalseForklift available at pickup. Default false.
liftgate_requiredbooleanNofalseLiftgate service required for this pickup. Default false.
pickup_weightstringNo—Total shipment weight in lbs. Alias: weight.

Example Request Body

{
  "items": [
    {
      "device_category": 4,
      "qty": 2,
      "brand": "Apple",
      "model": "MacBook Pro 14"
    },
    {
      "device_category": "phone",
      "qty": 5,
      "brand": "Samsung",
      "model": "Galaxy S23"
    }
  ],
  "shipping_name": "Acme Corp IT",
  "shipping_address_1": "500 Logistics Way",
  "shipping_address_2": "Suite 200",
  "shipping_city": "San Jose",
  "shipping_state": "CA",
  "shipping_country": "US",
  "shipping_zip": "95110",
  "shipping_phone": "4085551234",
  "shipping_email": "it@acme.com",
  "recovery_option": "send_me_a_box"
}

Response

FieldTypeDescription
messagestringOrder placement result message.
order_numberstringNumeric order number for tracking and cancellation.

Notes

  • shipping_name, shipping_address_1, shipping_city, shipping_state, shipping_country, shipping_zip, and shipping_phone are required.
  • Each item must include device_category, qty, brand, and model.
  • recovery_option: send_me_a_box (default), print_a_label, or request_pickup. Omitted or invalid values default to send_me_a_box.
  • send_me_a_box uses the shipping address on the order — no extra fields.
  • print_a_label requires number_of_labels, weight_lbs, weight_oz, length_in, width_in, and height_in.
  • request_pickup requires contact, pickup location, pickup_date, pickup_time, pickup_service (inside_pickup or liftgate_service_pickup), and pickup_description.
  • If recovery cannot be completed for the region, the order is still created and order_number is returned. Message: "Order placed successfully. But the recovery option is not available for this region."
  • Mexico (MX) only supports request_pickup for recovery. print_a_label requires UPS logistics in the ship-from country.

Related Endpoints

Order List

View ITAD orders

Cancel Order

Cancel an open order

Did this page help you?