When you make an API call to ASAPP and there is an error, you will receive a non 2XX HTTP status code.

All errors return a message, code, and requestId for that request to help you debug the issue.

The message will usually contain enough information to help you resolve the issue. If you require further help, reach out to support, including the requestId so that they can pinpoint the specific failing API call.

Error Structure

FieldTypeDescription
errorobjectThe main error object containing details about the error
error.requestIdstringA unique identifier for the request that resulted in this error
error.messagestringA detailed description of the error, including the specific validation issue
error.codestringAn error code in the format “HTTP_STATUS_CODE-ERROR_SUBCODE”

Here is an example where a timestamp in the request has an incorrect format.

{
  "error":{
    "requestId":"3851a807-f0c3-4873-8ba6-5bad4261f0ca3100",
    "message":"ERROR - [Path '/timestamp'] String 2024-08-14T00:00:00.000K is invalid against requested date format(s) [yyyy-MM-dd'T'HH:mm:ssZ, yyyy-MM-dd'T'HH:mm:ss.[0-9]{1,12}Z]: []]",
    "code":"400-03"
  }
}