Veridion APIs use standard HTTP response codes to indicate various classes of success or error responses. Below is a list of the codes returned by our APIs.


HTTP StatusDescription
200 OKStandard HTTP successful response.
202 AcceptedThe request was acknowledged and processed but no response was available. The caller should retry the request later.
400 Bad RequestStandard HTTP invalid request response.

The request body does not match the expected schema or invalid parameters were passed. Check the error response message field for additional information.
401 UnauthorizedStandard HTTP unauthorized access response.

Authentication is invalid. Check if the x-api-key header is passed correctly. Read more on Authenticating Requests.
403 ForbiddenStandard HTTP forbidden access response.

API Quotas were reached or you don't have enough permissions to access the requested resource. Please contact technical support for more information.
429 Too Many RequestsStandard HTTP response for exceeding rate limits.

Please wait for a few seconds and then retry the request. Read more on Rate Limiting.
500 Internal Server ErrorStandard HTTP response for an unexpected error that occurred on our server.

Please retry the request or contact technical support if the error persists.
503 Service UnavailableStandard HTTP service unavailable response, indicating that the server is temporarily unable to handle the request.

Please retry the request or contact technical support if the error persists.
504 Gateway timeoutStandard HTTP response for server timeout when attempting to complete the request.

Please retry the request or contact technical support if the error persists.