Error Responses

The following table lists the current HTTP response codes and associated messages that are returned in case of errors.

Endpoint Error Message Comment
HTTP response code: 400
Submit a Report Definition Bad Request Malformed request. Missing mandatory parameters
Cancel a Report Reports can only be cancelled if not in a final state.  
Delete a Report Reports can only be deleted if they are in a final state The final states are: READY, CANCELLED, or ERROR
HTTP response code: 401
All Unauthorized  
HTTP response code: 404
Cancel a Report, Get a Report's Metadata, and Fetch a Report's Results Not found Either the url is wrong, or user is attempting to poll a status of a report that doesn’t exist.
HTTP response code: 409
Fetch a Report's Results Report does not have status READY for downloading Occurs when attempting to download a report that isn’t finished yet, or has status failed.
HTTP response code: 422
Submit a Report Definition and Validate a Report Definition Please select a time frame no longer than six months.  
Submit a Report Definition and Validate a Report Definition Please specify a report time frame that does not include the last three days  
Submit a Report Definition and Validate a Report Definition End date has to be after start date  
Submit a Report Definition and Validate a Report Definition Your query contained dimensions that are unsupported. Please refer to the documentation and support regarding limitations  
Submit a Report Definition and Validate a Report Definition Your query contained metrics that are unsupported. Please refer to the documentation and support regarding limitations.  
Submit a Report Definition and Validate a Report Definition Your query filter is invalid. Please refer to the documentation and support regarding limitations.  
Submit a Report Definition and Validate a Report Definition Combination of dimensions and/or metrics is invalid. Please refer to the documentation and support regarding limitations.  
Submit a Report Definition and Validate a Report Definition Your query category hierarchy depth exceeded max category depth. Please refer to the documentation and support regarding limitations.  
Submit a Report Definition and Validate a Report Definition Your query contained a filter with an unsupported dimension. Please refer to the documentation and support regarding limitations  
Submit a Report Definition and Validate a Report Definition ReportDefinition.<fieldname> may not be null / empty Some required field is set to null or empty, which is not allowed.
HTTP response code: 429
Submit a Report Definition Your report quota has been reached, and you cannot create a new report job until a currently running report job finishes. Please try again later.  

Was this article helpful?