Skip to content

Retrieve Items

GET /api/v1.0/items
Try it out ↗

Find Items

Usage Notes

This endpoint supports pagination using cursor-based pagination. Use the Link header to navigate to the next page of results.

Tips:

  • Use date filters to retrieve only recently updated items
  • The default page size is 20, maximum is 200
  • Filter by status to get items in specific states

Query Parameters

page_size integer optional

Number of items returned in response

updated_before string optional

Show items updated at or before date. Format ISO 8601

updated_after string optional

Show items updated after date. Format ISO 8601

status array optional

Comma-separated list of item statuses to filter by. If not specifies the default value is used.

external_id string optional

External id

mpn string optional

MPN

Request Headers

X-Thredup-Access-Token string required

Authentication token

Responses

Get list of items with current item data.

Example Response Body
[
  {
    "item_number": "ITM-23306775",
    "state": "deleted",
    "title": "Silk Evening Dress",
    "description": "Elegant and sophisticated style perfect for any occasion",
    "external_id": "EXT-DEF179",
    "mpn": "MPN-XYZ905",
    "price": 3999,
    "listed_price": 1599,
    "discount": {
      "max_discount": {
        "percentage": 25
      }
    },
    "msrp": 2495,
    "quality": "Q2",
    "condition_description": "Luxurious material with impeccable craftsmanship",
    "with_tag": true,
    "created_at": "2025-07-26T11:34:09Z",
    "updated_at": "2025-08-01T11:34:09Z",
    "category_id": 934,
    "brand_id": 3350,
    "warehouse_id": 4282,
    "fulfillment_delay_days": 100,
    "size": {
      "scale": "example_value",
      "name": "Sarah Johnson",
      "type": "YouthShoeSize"
    },
    "attributes": {
      "color": [
        "Tan"
      ],
      "material": [
        {
          "value": "Quartz",
          "percentage": 47
        }
      ],
      "accent": [
        "Tassels"
      ],
      "measurements": {
        "width": 100.0,
        "height": 100.0,
        "depth": 100.0,
        "drop_length": 100.0,
        "inseam": 14.0,
        "shorts_inseam": 1.0,
        "chest": 5.0,
        "center_back_length": 1.0,
        "dress_length": 10.0
      },
      "necklace_style": "example_value",
      "earring_style": "example_value",
      "bracelet_style": "example_value",
      "ring_style": "example_value",
      "ring_size": "8",
      "general_style": "Vacation",
      "jacket_style": "Military",
      "jean_wash": "Light Wash",
      "waist": "super low rise",
      "pant_style": "Palazzo",
      "serial_number": "example_value",
      "country_of_origin": "example_value"
    },
    "listing_error_messages": [
      "example_value"
    ]
  }
]

Unauthorized

No response body

This endpoint returns no response body for current status code.