Skip to content

Retrieve an Order

GET /api/v1.0/orders/{id}
Try it out ↗

Get an Order by Id

Path Parameters

id integer required

Request Headers

X-Thredup-Access-Token string required

Authentication token

Responses

Attributes of a single order

Returns a OrderGetResponse object.

Example Response Body
{
  "id": 1129,
  "state": "paid",
  "customer": {
    "email": "[email protected]",
    "phone_number": "+1-555-987-6543"
  },
  "amount": 1599,
  "created_at": "2025-08-06T11:34:09Z",
  "updated_at": "2025-07-21T11:34:09Z",
  "purchased_at": "2025-07-23T11:34:09Z",
  "shipping_address": {
    "line1": "789 Pine Road",
    "line2": "Suite 200",
    "city": "Phoenix",
    "state": "CA",
    "zip5": "90210",
    "name": "Jane Doe"
  },
  "order_payments": [
    {
      "id": 2639,
      "total_collected": 100,
      "transaction_type": "example_value"
    }
  ],
  "order_lines": [
    {
      "id": 3208,
      "item_number": "ITM-63114665",
      "listed_item_price": 6999,
      "amount": 3999,
      "net": 100,
      "discount": 100,
      "allowed_discount": {
        "max_discount": {
          "percentage": "<max_depth_reached>"
        }
      },
      "tax": 100,
      "estimated_payout": 100,
      "is_shipping_fee": false,
      "shipment_id": 9183,
      "mpn": "MPN-DEF931"
    }
  ],
  "shipments": [
    {
      "id": 4436,
      "state": "shipped",
      "carrier": "FedEx",
      "tracking_number": "1Z999AA1234567890",
      "tracking_url": "https://tracking.example.com/1Z999AA1234567890",
      "warehouse_id": 8442,
      "packed_at": "2023-01-01T00:00:00Z",
      "shipped_at": "2023-01-05T10:00:00Z",
      "expected_to_deliver_at": "2023-01-10T12:00:00Z",
      "delivered_at": "2023-01-09T09:00:00Z",
      "canceled_at": "2023-01-02T19:00:00Z"
    }
  ],
  "refunds": [
    {
      "id": 8534,
      "type": "cancellation",
      "source": "dropshipper",
      "state": "successful",
      "total_refunded": 100,
      "refund_lines": [
        {
          "id": 6124,
          "order_line_id": 8797,
          "amount": 6999,
          "description": "Beautiful vintage item with unique details"
        }
      ]
    }
  ],
  "cancelation_reason": "Customer requested change"
}

Unauthorized

No response body

This endpoint returns no response body for current status code.

Not Found

No response body

This endpoint returns no response body for current status code.