Skip to main content
Standard HTTP response status codes are used to indicate the success or failure of a request made to the Procuros API. Status codes in the 2XX range indicate success, codes in the 4XX and 5XX range indicate failure. HTTP status codes that can be returned by the Procuros API:

Error Responses

To help you troubleshoot your interactions with the Procuros API, we’ve included further information within the responses returned from failed requests to the API.

Message

4xx range responses will always include the message property. For example in the case of a 400, the message property will give you the reason why in English.

Errors

For “Validation Failed” Client Errors (HTTP status code 422), responses include an additional property errors, which list all request fields that failed validation and why. Example:

Handling an Error

Example

Error Handling Best Practises

The most common errors are related to missing or misconfigured data. Here is an example on how to handle these with the Report Outgoing Error Request endpoint.

Best Practise: Missing GTIN

  • Set errorType to: DATA.
  • Set the errorReason to: The GTIN/EAN :gtin couldn't be found and set up the gtin variable accordingly