Skip to content

Retrieve an Item

GET /api/v1.0/items/{item_number}
Try it out ↗

Retrieves an Item

Retrieves an item. Attribute "state" display if item is currently listed.

Path Parameters

item_number string required

Request Headers

X-Thredup-Access-Token string required

Authentication token

Responses

Attributes of single item

Returns a ItemGetResponse object.

Example Response Body
{
  "item_number": "ITM-24355963",
  "state": "errored",
  "title": "Women's Designer Handbag",
  "description": "Elegant and sophisticated style perfect for any occasion",
  "external_id": "EXT-XYZ255",
  "mpn": "MPN-DEF340",
  "price": 4995,
  "listed_price": 4995,
  "discount": {
    "max_discount": {
      "percentage": 43
    }
  },
  "msrp": 1599,
  "quality": "Q1",
  "condition_description": "Luxurious material with impeccable craftsmanship",
  "with_tag": true,
  "created_at": "2025-07-20T11:34:09Z",
  "updated_at": "2025-07-20T11:34:09Z",
  "category_id": 6550,
  "brand_id": 7310,
  "warehouse_id": 8047,
  "fulfillment_delay_days": 100,
  "size": {
    "sizing_id": 3328,
    "scale": "example_value",
    "name": "Michael Brown",
    "type": "NeutralGenderSize"
  },
  "attributes": {
    "color": [
      "Purple"
    ],
    "pattern": [
      "Zebra Print"
    ],
    "accent": [
      "Bow & Tie"
    ],
    "necklace_style": "example_value",
    "earring_style": "example_value",
    "bracelet_style": "example_value",
    "ring_size": "3",
    "skirt_length": "High Low",
    "neckline": "Crew Neck",
    "top_style": "Cropped",
    "sleeve_length": "Long Sleeve",
    "pant_cut": "Wide leg",
    "jean_wash": "Coated",
    "waist": "low rise",
    "pant_style": "Linen",
    "skirt_style": "Sheath",
    "country_of_origin": "example_value"
  },
  "listing_error_messages": [
    "example_value"
  ]
}

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.