Skip to main content

Errors

Troubleshoot your Event API implementation by learning about associated errors.

Error table#

HTTP Response CodeError CodeDescription
200N/ATypically OK, but see example of a 200 error scenario below.
400RequestBodyReadErrorError occurred when reading the request body.
400RequestJsonUnmarshalErrorEvent API was unable to unmarshal the request body.
400RequestValidationErrorThe contents of the request body failed our validation checks. Check that you’ve followed the parameter requirements correctly.
401UnauthorizedErrorUnauthorized or invalid authentication token.
403ForbiddenThe provided access token is not authorized on your account.
500, 502, 503InternalServerError, ServiceUnavailableErrorUnexpected errors on Rokt's end. Retry using exponential backoff or contact your Rokt support team.

Sample#

{    "data": {        "code": "RequestJsonUnmarshalError",        "message": "unable to unmarshal request body"    }}

200 error scenario#

HTTP Status 200 typically indicates a successful call. However, as the Event API is a batch API, a 200 response does not necessarily mean the whole request processed correctly. Developers should inspect the response payload to ensure all records have been processed. The response payload contains an error message as well as the specific event object that failed.

Level 1Level 2Level 3Level 4TypeDescription
dataBulkResponseItemObject
unprocessedRecordsList[BulkResponseItemObject]A list of objects that contain records that failed to process.
errorErrorObjectDescribes the error related to the record.
codeStringError code
messageStringDetailed error message
recordEventObjectField contains the original record that failed.
{    "data": {        "unprocessedRecords": [            {                "error": {                    "code": "ValidationError",                        "message": "Invalid content"                },                "record": {                    "clientEventId": "fff4deeb-cdee-49ff-9aad-61b1c4256ca6",                    "eventType": "conversion",                    "eventTime": "2020-05-22T10:21:29.339Z",                    "objectData": [                        {                            "name": "firstname",                            "value": "john"                        }                    ]                }            }        ]    }}
Was this article helpful?