SizeCharts
Application API for fetching size chart data and size recommendations for storefront display.
Fetch size chart data for products on storefront pages (PDP/PLP). Supports a 3-level fallback: product-specific → fit-type → brand/category generic.
Operations
GET
# Get size chart by query
FDK Method Name: getSizeChartByQuery
Fetch size chart data for a product using a 3-level fallback lookup: (1) product-level by item_code + gender, (2) fit-level by brand UID + category UID + fit_type + gender, (3) basic-level by brand UID + category UID. Either (item_code + gender) or (brand + category) must be provided. Returns status "not_found" with data null when no chart exists at any level.
Parameters
item_code
string
Product item code. Required when using product-level lookup (must be paired with gender).
gender
string
Product gender. Required for product-level lookup (paired with item_code). Also used as an additional filter at fit-level lookup when combined with brand + category + fit_type.
brand
integer
Brand UID (numeric). Required when using brand/category-level lookup (must be paired with category).
category
integer
Category UID (numeric). Required when using brand/category-level lookup (must be paired with brand).
vendor_code
string
Optional vendor code to narrow down results within a brand+category lookup.
fit_type
string
Optional fit type (e.g. slim, regular). Enables fit-level lookup when combined with brand + category.
measurement_type
string
Optional measurement type filter (e.g. body, garment).
Response
200
400
Size chart lookup completed. Check the `status` field: "success" — chart found and returned; "not_found" — no chart exists at any fallback level.
SizeChartResult
status
string
data
object (SizeChartResultData)
Nullable
SizeChartResultData
size_chart_data
object (SizeChartDataRow)
SizeChartDataRow
item_code
string
Nullable
brand_uid
integer
Numeric brand UID.
brand_slug
string
Nullable
category_uid
integer
Numeric category UID.
category_l3
string
Nullable
gender
string
Nullable
vendor_code
string
Nullable
measurement_type
string
fit_type
string
sizes
array of object (SizeEntry)
Array of SizeEntry
size_name
string
Display name of the size (e.g. S, M, L, XL).
priority
integer
| value >= 1
Sort order priority for this size entry.
brand_size_format_attribute
string
universal_size_attribute
string
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
template_configs
array of object (TemplateConfig)
Array of TemplateConfig
measurement_type
string
The measurement type this config applies to.
size_display
string
Which size system to display (e.g. UK, US, EU).
attribute_sequences
array of string
Ordered list of measurement attributes to display as table columns.
Examples
Parameters
item_code:
"ITEM001"
gender:
"men"
brand:
42
category:
7
vendor_code:
"VND001"
fit_type:
"regular"
measurement_type:
"body"
Was this section helpful?
GET
Response
Get size chart by query
getSizeChartByQuery
Personalised size recommendations for authenticated users on product pages. Resolved across three confidence tiers: same-brand history → cross-brand winner → pivot-attribute proximity.
Operations
GET
# Get personalised size recommendation
FDK Method Name: getSizeRecommendation
Returns a personalised size recommendation for an authenticated user for a given brand + category combination, resolved across three confidence tiers:
- **high** (Tier 1): strict majority (>50%) from the user's own purchase history with this brand. - **medium** (Tier 2): cross-brand winner translated to this brand's size via brand_comparison reverse-lookup. - **low** (Tier 3): pivot-attribute proximity match against the nearest popular brand's chart.
Requires the `x-user-data` header (injected by the API gateway) containing the authenticated user's `_id`. Returns status "no-recommendations" when no tier produces a result, and "not-available" when recommendations are administratively disabled for the category.
Parameters
brand
integer
Required
Brand UID (numeric) for which the size recommendation is requested.
category
integer
Required
Category UID (numeric) for which the size recommendation is requested.
fit_type
string
Optional fit type (e.g. slim, regular). Used to resolve Tier 2 and Tier 3 per-fit recommendations.
Response
200
400
401
Recommendation lookup completed. Check the `status` field: "success" — a recommendation was found; "no-recommendations" — all tiers exhausted, no result; "not-available" — recommendations are disabled for this category.
SizeRecommendationResult
status
string
data
object (SizeRecommendationData)
SizeRecommendationData
recommendation
string
Recommended size label (e.g. M, L, XL).
confidence
string
Confidence tier of the recommendation.
Enum
message
string
Present when status is not "success".
Examples
Parameters
brand:
42
category:
7
fit_type:
"regular"
Was this section helpful?
GET
Response