SizeCharts
Application API for fetching size chart data 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
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, (3) basic-level by brand UID + category UID. Either (item_code + gender) or (brand + category) must be provided.
Parameters
item_code
string
Product item code. Required when using product-level lookup (must be paired with gender).
gender
string
Product gender. Required when using product-level lookup (must be paired with item_code).
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.
Response
200
400
404
Size chart data fetched successfully.
SizeChartResult
status
string
data
object (SizeChartResultData)
SizeChartResultData
size_chart_data
array of object (SizeChartDataRow)
Array of 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
current_brand
string
tooltip_text
string
tooltip_title
string
measurement_unit
string
size_guide_measurement_unit
string
size_header
string
category_name
string
brand_name
string
vendor_name
string
image_based_size_chart
string
size_chart_image_url
string
brand_logo_url
string
pdp_tooltip_title
string
default_other_country_comparison
string
description
string
tips
string
how_to_measure_imageurl_1
string
how_to_measure_imageurl_2
string
show_tool_tip
string
size_chart_tooltip
string
model_size
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.
company_id
integer
source
string
Enum
created_by
string
updated_by
string
created_at
string
| date-time
updated_at
string
| date-time
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
Parameters are not required.
Was this section helpful?
GET
Response