HTTP Response Codes

Standard HTTP response codes

Both versions of the Pricing Advisor API exposes the API errors in two ways - HTTP response codes as well as human-readable messages in the JSON format.

Standard HTTP response codes

The following table lists the standard HTTP responses codes

Status Description
200 OK Request was successful. The response contains pricing data for all delivery countries.
400 Bad Request Request contains errors and could not be completed (e.g., missing mandatory parameters).
401 Unauthorized Request lacks valid authentication credentials for the requested resource.
403 Forbidden Access to the requested resource is forbidden.
404 Not Found The system could not locate the requested resource.
503 Service Unavailable Server is temporarily unavailable to handle the request.

API Specific Error Codes

Pricing Advisor API v2.0 Error Codes

Message Description
Invalid identifier value The identifier/brand code provided in the request is invalid.
Invalid deliveryCountryIso The ISO code of the delivery country is incorrect.
Invalid retailerCurrencyIso The ISO code of the retailer currency is not valid.

Pricing Advisor API v3.0 Error Codes

Error Description
deliveryCountryIso
  • The field deliveryCountryIso must be a string (Length: 2)
  • The field deliveryCountryIso is not a valid ISO code.
fromRetailerCurrencyIso
  • The field fromRetailerCurrencyIso must be a string (Length: 3)
  • The field fromRetailerCurrencyIso is not a valid ISO code.
identifier
  • The field identifier must be a string (Length: 6)
  • The field identifier is not a valid brand code.

Pricing Advisor API v4.0 Error Codes

Error Description
deliveryCountryIso
  • The field deliveryCountryIso must be a string (Length: 2)
  • The field deliveryCountryIso is not a valid ISO code.
fromRetailerCurrencyIso
  • The field fromRetailerCurrencyIso must be a string (Length: 3)
  • The field fromRetailerCurrencyIso is not a valid ISO code.
identifier
  • The field identifier must be a string (Length: 6)
  • The field identifier is not a valid brand code.