Fetches information about a garment. The garment format is implicitly set to detailed.
The JWT for the user. Optional: requests without a user token return non-personalized results. The header name is unchanged for backwards compatibility.
An identifier for the source item. The interpretation of this item is controlled by the identifier_type parameter
How Mapp Fashion should interpret the item id. Not all of these may be available, depending on the information in the product feed and how it is processed. Contact Mapp Fashion for examples of these types for your specific integration.
In general
- product-code is the style + color identifier from the feed
- sku is style without color or size (can be supplemented with an extra parameter specifying the color + size variant)
There is no fallback logic for partial matches: an identifier must match completely, and the first match is used for the response.
ancillary-product-code is an additional, optional product code. When used, it is checked against the product code column for a complete match.
If true, pretty print JSON output. This increases response size and should usually be off in production environments
Controls whether Mapp Fashion garment ids (raw_garment_id) are included in response
Deprecated. This parameter still returns data, but the logic behind it is no longer maintained and it has no v2 equivalent. Do not rely on it for new integrations.
A list of garment attributes to fetch. Only supported for garment_format=document or detailed. Retailer specific custom fields are named x-<field> and may be requested in addition to the values listed here - contact Mapp Fashion for details
A locale parameter describing what stock information to use and what language to return text in (if applicable). This parameter will only function if the corresponding information is in the product feed & processed accordingly. If stock local and UI language are not the same, specify the language parameter in addition to this one.
Allows you to specify a locale used for feed attributes such as product name that should be localized using a different locale to price & stock information. This parameter will only function if the corresponding information is in the product feed & processed accordingly.
Information about the garment
Fetches information about a garment. The garment format is implicitly set to detailed.
The garment_id. The type of identifier used depends on the requests' garment_format
The internal Mapp Fashion id for the garment. This may be omitted depending on garment_format
An alternative identifier to identify the product, hidden when not provided in feed
Whether garment has extended verdicts. Only presents for verdicts/dislikes, also not present if format=retailer_ids
Whether outfits can be generated. not present if format=retailer_ids
Information about the recommended size
Information about size immediately bigger than the recommended one (if available)
Information about size immediately smaller than the recommended one (if available)
If whys have been requested & if the profile has shape data, a list of human readable reasons for recommendation
If verdicts have been requested, the approval status of the garment (true=like, false=dislike, nil=no verdict given)
If owned has been requested, whether the use has previously purchased the product
A numerical score for the garment (out of 10)
A human readable interpretation of the score
If features have been requested, a list of whitelisted feature objects
The id for the feature
The human readable name for the feature
The feature category of the feature
The category id for the product.
The garment department (female male girls boys).
If eans have been requested, the array of eans present in the product feed.
The category name for the product.
Array of the product occasions. Only present if format=detailed, and only populated when occasions is requested via fields; otherwise the key may be returned as null. The possible values are casual, evening, occasion, holiday, work and creative_work
The retailer name for the product. Only present if format=detailed
The array of image_urls present in the product feed. Only present if format=detailed
The brand name for the product. Only present if format=detailed
The product name. Only present if format=detailed
The current price, as it appears in the feed. Only present if format=detailed
The previous price, as it appears in the feed. Only present if format=detailed
The URL for the PDP for the garment. Only present if format=detailed
The status of the garment. Only present if format=detailed
Product feed attributes, as agreed with Mapp Fashion
The name of the attribute
The value of the attribute (if string valued)
The value of the attribute (if array valued)
One or more parameter values are invalid
Generic error object
A human readable error message
Invalid JWT: a user token was supplied but could not be verified. Requests without a user token are not affected - they return non-personalized results
Generic error object
A human readable error message
garment not found
Generic error object
A human readable error message
An internal error occurred. Retry the request. If the issue persists, contact Technical Support
Generic error object
A human readable error message