/
5 minute read
January 5, 2023

Errors DiVA API

The DiVA API uses standard HTTP response codes to indicate the status of requests. When errors occur, the API may return an error message. You can use the response codes and error messages to aid in debugging requests and to improve your exception handling capability. Core API error codes are listed separately.

Response codes

The DiVA API uses standard HTTP response codes to indicate the status of requests. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error in the request, and codes in the 5xx range indicate an error on the Marqeta platform.

The following table shows some common response codes:

Response Code Description

200 Successful

Request completed successfully.

202 Accepted

Request accepted for asynchronous file export. A body of "Pending" indicates that processing of the file is underway.

400 Bad Request

Request is not properly formed. For example, the query filter syntax is incorrect.

403 Forbidden

Credentials do not authorize user to view the requested resource.

404 Not Found

Request URL is not properly formed. For example, the aggregation level path parameter is missing.

410 Gone

The requested file has expired and cannot be retrieved. Try exporting and then downloading the file again.

429

Requests exceed rate limits, which accept a maximum of 300 report requests per five-minute interval (one per second).

Error codes and messages

Error codes are based on HTTP response codes. The first three digits include the HTTP response code and the last three digits represent the error.

Common error codes 403

Error Code Description

403001

Field forbidden exception

403002

Filters forbidden exception

403003

Program forbidden exception

Subscribe to our developer newsletter