Skip to content

The Order Object

An order response includes which items were purchased, their actual prices and discounts, customer address, etc. Order lines and items are linked via the item_number item property.

Purchased items are transferred into the purchased state.

customer

The information in the customer field is masked and identical for all orders, it should not be used to identify individual customers.

Note

Only the shipping_address field contains actual customer information.

purchased_at

The purchased_at timestamp reflects the actual date and time when the items were purchased by the customer on ThredUP.

This is the moment the purchase transaction was completed, before any fraud review or further processing.

created_at

The created_at timestamp indicates when the order became available via the API.

Note

Since ThredUP performs a fraud check before orders become available via the API, there can be a delay between the purchased_at time and the created_at time.

order_lines

The order_lines contain the information about items that were purchased:

  • An order line contains an item_number field, which connects it to the listed item that was bought.
  • listed_item_prices contains the rounded item price at the moment of purchase. Might be different from the one set by the dropshipper due to the time it takes to sync the price update back to the main system.
  • amount is the total amount that the customer paid

Note

The final amount is calculated by taking the listed item price, subtracting any discount applied, and then adding the applicable tax.

  • allowed_discount shows the maximum percentage of discount allowed at the moment of purchase. Might be different from the one set by the dropshipper due to the time it takes to sync the discount update back to the main system.
  • estimated_payout contains the estimated payout the dropshipper will receive.
  • Additionally, there is a special type of order line: a shipping fee line, which is denoted by the is_shipping_fee boolean flag and contains amounts a customer paid in shipping fees.

Note

The item_number value for a shipping fee order line is null.