SizeCharts
Application API for fetching size chart data and size recommendations for storefront display.
Storefront read for the per-application size-to-size mapping table used to render cross-country size comparisons. Resolved across three confidence tiers: same-brand history → cross-brand winner → pivot-attribute proximity.
Operations
GET
# Get default country comparison config
FDK Method Name: getDefaultCountryComparisonConfig
Fetch the singleton default country-comparison table used to render cross-country size mappings on the storefront.
Note: the handler also returns 404 with `status: not_found` when no config has been created yet — clients should render an empty state. That path is not contract-tested because the endpoint has no input to discriminate "found" from "missing".
Parameters
No Parameters
Response
200
Config found and returned.
DefaultCountryComparisonConfigResult
status
string
data
object (DefaultCountryComparisonConfigData)
Nullable
DefaultCountryComparisonConfigData
sizes
array of object (DefaultCountryComparisonSizeRow)
Array of DefaultCountryComparisonSizeRow
priority
integer
| value >= 1
Row sort key.
uni
string
Nullable
uk
string
Nullable
us
string
Nullable
eu
string
Nullable
aus
string
Nullable
ca
string
Nullable
br
string
Nullable
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.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Get default country comparison config
getDefaultCountryComparisonConfig
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_measurement, garment_measurement).
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_attribute
string
Brand size value (e.g. "10", "M"). The actual size label as the brand declares it.
brand_size_format
string
Format/system the brand_size_attribute is expressed in (e.g. "UK"). Renamed from brand_size_format_attribute in the post-migration schema; the value already names the format so the _attribute suffix was redundant.
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.
country_sequences
array of string
Ordered list of country/region codes (e.g. in, uk, eu) used to render the international size-comparison row on the storefront.
brand_sequences
array of string
Ordered list of brand slugs used to render cross-brand size comparison on the storefront.
other_attributes
array of string
Catch-all list of unmapped attribute names that do not belong to any standard sequence.
Examples
Parameters
item_code:
"ITEM001"
gender:
"men"
brand:
42
category:
7
vendor_code:
"VND001"
fit_type:
"regular"
measurement_type:
"body_measurement"
Was this section helpful?
GET
Response
Get size chart by query
getSizeChartByQuery
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