REST API

Error codes

Each REST error response includes a help URL that opens one of these pages. Endpoint reference lives in the API documentation.

Code HTTP Message
validation-01 412 Precondition Failed Search request do not pass validation
validation-02 412 Precondition Failed Tracking request do not pass validation
validation-03 412 Precondition Failed Catalog request do not pass validation
validation-04 412 Precondition Failed Request Id do not pass validation
validation-05 412 Precondition Failed API version do not pass validation
validation-06 412 Precondition Failed Stylist request do not pass validation
validation-07 412 Precondition Failed Social Proof request do not pass validation
validation-08 412 Precondition Failed Recommendation request do not pass validation
validation-09 412 Precondition Failed Tracking click request do not pass validation
validation-10 412 Precondition Failed Tracking product view request do not pass validation
validation-11 412 Precondition Failed Universal Tile request do not pass validation
validation-12 412 Precondition Failed Catalog product store request do not pass validation
version-02 412 Precondition Failed Selected API version is not supported
customer-01 403 Forbidden Provided customer symbol is not active
search-01 412 Precondition Failed Search id is not valid
search-02 403 Forbidden Search is not enabled
catalog-01 412 Precondition Failed Catalog id is not valid
catalog-02 412 Precondition Failed Catalog id is not configured
search-03 412 Precondition Failed Search id is not configured
sort-01 403 Forbidden Selected sort type is not configured
filter-01 403 Forbidden Selected filter is not allowed by configurations
page-01 412 Precondition Failed Pagination configuration is invalid
empty-full-match-01 403 Forbidden Fullmatch fields configuration is invalid
empty-multi-match-01 403 Forbidden Multimatch fields configuration is invalid
empty-exact-search-01 403 Forbidden Exact search fields configuration is invalid
route-01 404 Not Found Catalog API request route not found
route-02 404 Not Found Search API request route not found
route-03 404 Not Found Tracking API request route not found
route-04 404 Not Found Stylist API request route not found
route-05 404 Not Found SocialStream API request route not found
route-06 404 Not Found SocialProof API request route not found
route-07 404 Not Found Recommendation API request route not found
route-08 404 Not Found Lookbook API request route not found
route-09 404 Not Found Cookie API request route not found
route-10 404 Not Found Preview API request route not found
route-11 404 Not Found Universal Tile API request route not found
auth-01 401 Unauthorized Request is not authorized
too-many-requests-01 429 Too Many Requests Too many requests
module-not-allowed-01 403 Forbidden Module catalog is not allowed
module-not-allowed-02 403 Forbidden Module search is not allowed
module-not-allowed-03 403 Forbidden Module tracking is not allowed
module-not-allowed-04 403 Forbidden Module stylist is not allowed
module-not-allowed-05 403 Forbidden Module recommendation is not allowed
stylist-instance-02 412 Precondition Failed Stylist instance id is not valid
stylist-instance-01 404 Not Found Stylist instance ID not found
stylist-instance-data-not-calculated 503 Service Unavailable Data for Stylist instance id is not ready to use
recommendation-generate-internal 500 Internal Server Error Recommendation frame generation failed due to an internal error.
unknown-error 500 Internal Server Error Internal error occurred
universal-tile-01 404 Not Found Universal Tile ID not found