Retrieve Orders

Once a customer purchases a listed item, the corresponding order becomes available via the API.

Send the Request

You can retrieve all orders (since there are none yet, this will return the most recent one):

curl https://dropshipping.thredtest.com/api/v1.0/orders \
  -H "Content-Type: application/json" \
  -H "X-Thredup-Access-Token: YOUR_ACCESS_TOKEN"

Review the Response

If successful, the API returns a 200 OK response with a list of one or more orders in the response body:

[
  {
    "id": 43,
    "state": "paid",
    "customer": {
      "email": "[email protected]",
      "phone_number": "6175759676"
    },
    "amount": 33184,
    "created_at": "2025-06-10T15:48:08Z",
    "updated_at": "2025-06-10T15:48:08Z",
    "purchased_at": "2025-06-10T15:47:43Z",
    "shipping_address": {
      "line1": "969 BROADWAY STE 200",
      "line2": null,
      "city": "OAKLAND",
      "state": "CA",
      "zip5": "94607",
      "name": "Oleksandr Oksenenko"
    },
    "order_payments": [
      {
        "id": 44,
        "total_collected": 33184,
        "transaction_type": "purchase"
      }
    ],
    "order_lines": [
      {
        "id": 91,
        "item_number": null,
        "listed_item_price": 0,
        "amount": 0,
        "net": 0,
        "discount": 0,
        "allowed_discount": {
          "max_discount": {
            "percentage": 0
          }
        },
        "tax": 0,
        "estimated_payout": 0,
        "is_shipping_fee": true,
        "shipment_id": null
      },
      {
        "id": 90,
        "item_number": "1500003295",
        "listed_item_price": 30099,
        "amount": 33184,
        "net": 30099,
        "discount": 0,
        "allowed_discount": {
          "max_discount": {
            "percentage": 0
          }
        },
        "tax": 3085,
        "estimated_payout": 24079,
        "is_shipping_fee": false,
        "shipment_id": null
      }
    ],
    "shipments": [],
    "refunds": [],
    "cancelation_reason": null
  }
]