Common error responses
The shared error envelope and the 4xx and 5xx codes every endpoint can return.
The following error responses are shared across all endpoints.
All error responses return a JSON object containing the message shown below.
| Code | Description | Message |
|---|---|---|
400 |
Bad or missing input parameter | |
401 |
Unauthorized - The request is not authorized. | API Key Inactive |
402 |
Insufficient Credit - Insufficient credit to process this request | Insufficient Credit |
403 |
No access - No permission to process this request | No access |
429 |
Rate limited - The request rate limit has been reached | Rate limited |
503 |
DVS Service is unavailable. This is returned if the DVS returns a System Error result. The request was not successful and should be retried later. | DVS returned a system error. Please try again later. |
5XX |
Internal error - Internal system error | Internal error |
DvsNoAccess |
No access - No permission to process this request. This is returned if the account does not have access to this check, or if DVS has not authorised the OAC the check was sent under. The second is a refusal from DVS itself: the OAC must be approved for the check with DVS, and retrying the request will not change the result. | No access |