Retrieve Orders

Use this endpoint to retrieve the list of orders for your account.

If there are more than page_size orders, the results will be paginated using cursor based pagination. Refer to the pagination section for details on how to fetch subsequent pages.

Endpoint details

GET /api/v1.0/orders

Try it out ↗

Fetch Orders

Query Parameters

page_size integer optional

Number of orders returned in response

created_after string optional

Show orders created at or after date. Format ISO 8601

created_before string optional

Show orders created before date. Format ISO 8601

updated_after string optional

Show orders updated at or after date. Format ISO 8601

updated_before string optional

Show orders updated before date. Format ISO 8601

Request Headers

X-Thredup-Access-Token string required

Authentication token

Responses

200 Success401 Unauthorized

Return array of orders

Example Response Body

[
  {
    "id": 4509,
    "state": "paid",
    "customer": {
      "email": "[email protected]",
      "phone_number": "+1-555-555-0123"
    },
    "amount": 3999,
    "created_at": "2025-08-01T11:34:09Z",
    "updated_at": "2025-08-09T11:34:09Z",
    "purchased_at": "2025-07-28T11:34:09Z",
    "shipping_address": {
      "line1": "654 Maple Drive",
      "line2": "Suite 200",
      "city": "Los Angeles",
      "state": "AZ",
      "zip5": "90210",
      "name": "Emily Davis"
    },
    "order_payments": [
      {
        "id": 8964,
        "total_collected": 100,
        "transaction_type": "example_value"
      }
    ],
    "order_lines": [
      {
        "id": 1277,
        "item_number": "ITM-26347428",
        "listed_item_price": 3999,
        "amount": 4995,
        "net": 100,
        "discount": 100,
        "allowed_discount": {
          "max_discount": "<max_depth_reached>"
        },
        "tax": 100,
        "estimated_payout": 100,
        "is_shipping_fee": false,
        "shipment_id": 6841,
        "mpn": "MPN-DEF319"
      }
    ],
    "shipments": [
      {
        "id": 5337,
        "state": "canceled",
        "carrier": "FedEx",
        "tracking_url": "https://tracking.example.com/CP123456789US",
        "warehouse_id": 7297,
        "packed_at": "2023-01-01T00:00:00Z",
        "shipped_at": "2023-01-05T10:00:00Z",
        "expected_to_deliver_at": "2023-01-10T12:00:00Z",
        "canceled_at": "2023-01-02T19:00:00Z"
      }
    ],
    "refunds": [
      {
        "id": 158,
        "type": "order_refund",
        "source": "thredup",
        "state": "pending",
        "total_refunded": 100,
        "refund_lines": [
          {
            "id": "<max_depth_reached>",
            "order_line_id": "<max_depth_reached>",
            "amount": "<max_depth_reached>"
          }
        ]
      }
    ],
    "cancelation_reason": "Customer requested change"
  }
]

Unauthorized

No response body

This endpoint returns no response body for current status code.