👕 Garment Sizes
How clothing and shoe sizes appear in shopping data
When a person shares their shopping profile with you, the response from /storage/shopping can include their clothing and shoe sizes, and their body data. You can use these to preselect the right size on a product page, filter a catalogue, recommend items that fit, or run your own size advice.
Sizes Are Given per Scale
Clothing and shoes are sized differently for women and men, so every size category comes as an object with both scales:
"topSizes": { "women": ["m", "l"], "men": [] }Use the scale that matches the product, not the person. Selling a men's shirt? Read topSizes.men. Selling a dress? Read dressSizes.women.
Both keys are always there. A scale the person didn't fill in, or doesn't share, is an empty list. Some categories currently only exist on one scale, like dresses or suits; the other scale is then always an empty list, so the format won't change if it's added later. We never convert one scale into the other.
Every value is a list, so you read every category the same way. Categories with a single size per person, such as trousers, are a list of one.
Which Sizes You Can Receive
| Field | What it is | Women's | Men's |
|---|---|---|---|
topSizes | Tops, shirts and sweaters | ["m", "l"], xxs to 5xl | ["l"], xs to 5xl |
dressSizes | Dresses and skirts, EU | [38, 40] | [] |
suitSizes | Suits, EU | [] | [50] |
dressShirtSizes | Dress shirts | [] | [{ "collar": 39, "extraLongSleeves": true }] |
trouserSizes | Jeans and trousers, in inches | [{ "waist": 30, "length": 32 }] | [{ "waist": 33, "length": 34 }] |
braSizes | Bra band and cup, EU | [{ "band": 75, "cup": "c" }] | [] |
shoeSizes | Shoes, EU | [38, 39] | [43] |
Letter sizes and bra cups are lower case. A trouser or bra size can have only one of its parts, for example { "waist": 33 } when the person didn't give a length. A dress shirt with extra-long sleeves is what's usually written as 39-7.
Picking a Scale
Use the scale that matches the product: women for women's clothing, men for men's. For a product that's sold for both, such as a unisex sneaker, start from the scale the person has sizes on. If they have sizes on both, start from the scale with the most sizes across the whole response.
Body Data
The shopping profile can also include the person's body data, which you can use for your own size advice:
| Field | What it is | Example |
|---|---|---|
height | Height in centimetres | 175 |
weight | Weight in kilograms | 70 |
chestShape | Chest relative to average | "average" |
waistShape | Waist relative to average | "narrow" |
hipShape | Hips relative to average | "wide" |
We don't calculate sizes from the body data: the sizes you receive are always the ones the person filled in.
Some Sizes May Be Missing
People choose which of their clothing sizes they share, per scale. A category that isn't shared on either scale is left out of the response, so treat every size field as optional. When a field or scale is missing or empty, show your normal size picker without a preselection. Shoe sizes are always shared when filled in.
Example Response
{
"height": 168,
"weight": 61,
"topSizes": { "women": ["m", "l"], "men": [] },
"trouserSizes": { "women": [{ "waist": 30, "length": 32 }], "men": [] },
"braSizes": { "women": [{ "band": 75, "cup": "c" }], "men": [] },
"shoeSizes": { "women": [39], "men": [] }
}This person shares their women's tops, trouser, bra and shoe sizes. They don't share a dress size, so dressSizes is missing.
Sizes in Raw Data
If the person gave you consent to read their raw shopping data (/storage/shopping/raw), you get the sizes as they're stored, one field per scale and part, such as topLetterSizesWomen: ["m"], trouserWaistMen: 33 and trouserLengthMen: 34.
TypeScript Types
type PerScale<T> = { women: T[]; men: T[] };
type LetterSize =
'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl' | '3xl' | '4xl' | '5xl';
type BodyShape = 'narrow' | 'average' | 'wide';
type ShoppingSizes = {
topSizes?: PerScale<LetterSize>;
dressSizes?: PerScale<number>;
suitSizes?: PerScale<number>;
dressShirtSizes?: PerScale<{ collar: number; extraLongSleeves: boolean }>;
trouserSizes?: PerScale<{ waist?: number; length?: number }>;
braSizes?: PerScale<{ band?: number; cup?: string }>;
shoeSizes?: PerScale<number>;
height?: number;
weight?: number;
chestShape?: BodyShape;
waistShape?: BodyShape;
hipShape?: BodyShape;
};Related Documentation
- Anonymized Profile Data - Format of the profile response
- API Reference - Complete client library API documentation