Retrieve Categories
GET
/api/v1.0/categories
Fetch Categories
Return tree of existing categories together with allowed and default sizes.
Request Headers
X-Thredup-Access-Token string required
Authentication token
Responses
Return tree of categories
Example Response Body
[
[
{
"id": 66,
"name": "Handbags",
"gender": "women",
"sizing_type": "WomenHandbagSize",
"allowed_sizes": {
"Fits All": [
"One Size"
]
},
"default_size": {
"scale": "Fits All",
"name": "One Size"
},
"children": [
{
"id": 75,
"name": "Leather",
"children": [
{
"id": 861,
"name": "leather baby bag"
},
{
"id": 980,
"name": "leather clutch"
},
{
"id": 979,
"name": "leather crossbody"
},
{
"id": 978,
"name": "leather hobo"
},
{
"id": 973,
"name": "leather laptop"
},
{
"id": 977,
"name": "leather satchel"
},
{
"id": 976,
"name": "leather shoulder bag"
},
{
"id": 982,
"name": "Leather Coin Purse"
},
{
"id": 975,
"name": "leather tote"
},
{
"id": 872,
"name": "leather wallet"
},
{
"id": 974,
"name": "leather weekender"
},
{
"id": 1018,
"name": "Leather Belt Bag"
},
{
"id": 870,
"name": "leather wristlet"
},
{
"id": 981,
"name": "leather backpack"
},
{
"id": 1002,
"name": "Leather Bucket Bag"
},
{
"id": 1005,
"name": "Leather Card Holder"
},
{
"id": 255,
"name": "Leather Messenger"
}
]
},
{
"id": 76,
"name": "Non-Leather",
"children": [
{
"id": 871,
"name": "baby bag"
},
{
"id": 859,
"name": "clutch"
},
{
"id": 860,
"name": "crossbody"
},
{
"id": 862,
"name": "hobo"
},
{
"id": 867,
"name": "laptop"
},
{
"id": 863,
"name": "satchel"
},
{
"id": 864,
"name": "shoulder"
},
{
"id": 865,
"name": "tote"
},
{
"id": 869,
"name": "wallet"
},
{
"id": 866,
"name": "weekender"
},
{
"id": 868,
"name": "wristlet"
},
{
"id": 423,
"name": "backpack"
},
{
"id": 1017,
"name": "Belt Bag"
},
{
"id": 1001,
"name": "Bucket Bag"
},
{
"id": 1003,
"name": "Coin Purse"
},
{
"id": 1004,
"name": "Card Holder"
},
{
"id": 911,
"name": "messenger"
}
]
}
]
},
{
"id": 50,
"name": "Accessories",
"gender": "women",
"sizing_type": "WomenSize",
"allowed_sizes": {
"US": [
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32"
],
"S-M-L": [
"P",
"XXS",
"XS",
"S",
"M",
"L",
"XL",
"XXL",
"0X",
"1X",
"2X",
"3X",
"4X",
"5X"
],
"Fits All": [
"One Size"
]
},
"default_size": {
"scale": "Fits All",
"name": "One Size"
},
"children": [
{
"id": 49,
"name": "Hats",
"children": [
{
"id": 409,
"name": "Hat"
},
{
"id": 410,
"name": "Winter Hat"
},
{
"id": 412,
"name": "Baseball Cap"
},
{
"id": 413,
"name": "Beanie"
},
{
"id": 414,
"name": "Visor"
},
{
"id": 734,
"name": "Sun Hat"
},
{
"id": 840,
"name": "Fedora"
}
]
},
{
"id": 71,
"name": "Belts",
"children": [
{
"id": 416,
"name": "Belt"
},
{
"id": 824,
"name": "Leather Belt"
}
]
},
{
"id": 72,
"name": "Scarves",
"children": [
{
"id": 417,
"name": "Scarf"
},
{
"id": 815,
"name": "Cashmere Scarf"
},
{
"id": 818,
"name": "Silk Scarf"
}
]
},
{
"id": 73,
"name": "Gloves",
"children": [
{
"id": 419,
"name": "Mittens"
},
{
"id": 420,
"name": "Gloves"
}
]
},
{
"id": 74,
"name": "Other",
"children": [
{
"id": 726,
"name": "Watch"
},
{
"id": 421,
"name": "Tights"
},
{
"id": 422,
"name": "Makeup Bag"
},
{
"id": 424,
"name": "Sunglasses"
},
{
"id": 426,
"name": "Wrap"
},
{
"id": 997,
"name": "Ear Muffs"
}
]
}
]
},
{
"id": 117,
"name": "Jewelry",
"gender": "women",
"sizing_type": "WomenSize",
"allowed_sizes": {
"US": [
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32"
],
"S-M-L": [
"P",
"XXS",
"XS",
"S",
"M",
"L",
"XL",
"XXL",
"0X",
"1X",
"2X",
"3X",
"4X",
"5X"
],
"Fits All": [
"One Size"
]
},
"default_size": {
"scale": "Fits All",
"name": "One Size"
},
"children": [
{
"id": 123,
"name": "Necklaces",
"children": [
{
"id": 1009,
"name": "Necklace"
}
]
},
{
"id": 122,
"name": "Brooches",
"children": [
{
"id": 1010,
"name": "Brooch"
}
]
},
{
"id": 121,
"name": "Earrings",
"children": [
{
"id": 1011,
"name": "Earring"
}
]
},
{
"id": 119,
"name": "Bracelets",
"children": [
{
"id": 1013,
"name": "Bracelet"
}
]
},
{
"id": 120,
"name": "Rings",
"children": [
{
"id": 1015,
"name": "Ring"
}
]
}
]
}
]
]
Unauthorized
No response body
This endpoint returns no response body for current status code.