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

200 Success401 Unauthorized

Get list of items with current item data.

Example Response Body

[
  {
    "item_number": "1234567890",
    "state": "listed",
    "title": "Louis Vuitton x Takashi Murakami Neverfull MM Multicolor White Tote",
    "description": "Authentic Louis Vuitton x Takashi Murakami Neverfull MM in iconic white multicolor monogram canvas. Features colorful LV monogram print with rainbow colors on white background. Interior in excellent condition with minimal signs of use. Vachetta leather handles show light honey patina. Includes original pouch.",
    "external_id": "LUX-LVTM-NF-12345",
    "mpn": "M40049",
    "price": 124999,
    "listed_price": 124999,
    "discount": {
      "max_discount": {
        "percentage": 10
      }
    },
    "msrp": 200000,
    "quality": "Q1",
    "condition_description": "Light patina on handles, minor wear on corners, interior clean",
    "with_tag": false,
    "created_at": "2026-03-10T10:00:00Z",
    "updated_at": "2026-03-10T10:00:15Z",
    "category_id": 865,
    "brand_id": 65673,
    "warehouse_id": 10053,
    "fulfillment_delay_days": 0,
    "size": {
      "scale": "Fits All",
      "name": "One Size"
    },
    "attributes": {
      "color": [
        "Multi Color",
        "White"
      ],
      "material": [
        {
          "value": "Coated Canvas",
          "percentage": 85
        },
        {
          "value": "Leather",
          "percentage": 15
        }
      ],
      "pattern": [
        "Graphic"
      ]
    },
    "listing_error_messages": []
  }
]

Unauthorized

No response body

This endpoint returns no response body for current status code.