Errors

Report Library API errors return both an HTTP status code and an error message. Errors caused by the client return a 4xx Client Error status code. Errors caused by the API service return a 5xx Server Error status code.

Example error response

{
  "code": "user_authentication_error",
  "message": "User is not authenticated. Verify the API key in your request."
}

Response parameters

Name	Type	Description
errors	array	List of errors from the request.
.. code	string	Error code identifying a specific error.
.. message	string	Description of the error.

4xx Client Error codes

Status	Code	Description
400	disabled_report_type	Report type disabled. API requests to edit a report or start a report run return this error if the report in the request is of a report type no longer enabled for the account. For a list of enabled report types, send a request to the List report types endpoint. For help reactivating report types, contact support.
400	missing_mandatory_field: {{variable}}	The request is missing a required field. In the error response, `{{variable}}` returns the name of the required field. Update the field in the request and try again.
400	invalid_date	The `run_until` date is in the past. Submit another request with a `run_until` date in the future.
400	invalid_column_identifiers	One or more `column_identifiers` in the request are not supported for the chosen `report_type`. To get the column identifiers each report type supports, use the List columns endpoint.
400	invalid_email	The `notification_emails` parameter contains an invalid value. In the request body, make sure each object in the `notification_emails` array contains a valid `user_id`, `first_name`, `last_name`, and `email` that belongs to an admin user.
400	invalid_filter	Request contains one or more invalid filter. In the request body, make sure each `filter` object includes: A valid `filter_identifier` value. A valid `column_identifier` value. A `values` array that is not null. To get the filter and column identifiers each report type supports, use the List columns endpoint. For more information about filters, see Column filters.
400	invalid_limit	Invalid limit value. Pagination limits must be a positive integer.
400	invalid_offset	Invalid offset value. Pagination offset must be an integer greater than or equal to 0.
400	invalid_request: {{variable}}	In the error code, the `{{variable}}` is replaced with the name of the field that contains an invalid value. Submit another request with a valid `{{variable}}` value.
400	invalid_schedule	The request includes an invalid `schedule` object.If `frequency` = `WEEKLY`, make sure your request includes a valid value for the `repeat_every` and `weekday_to_run` request parameters. If `frequency` = `MONTHLY`, make sure your request includes a valid value for the `repeat_every` and `repeat_on` request parameters. Also: If `repeat_on` = `DAY_OF_THE_MONTH`, make sure your request includes a valid value for either the `weekday_to_run` or `weekday_frequency` request parameters. If `repeat_on` = `DATE_OF_THE_MONTH`, make sure your request includes valid data in the `repeat_on_date` object. For examples of `schedule` objects with different structures, see How to build a report - Schedule report.
400	invalid_sub_account_type	The `sub_account_filter_type` request parameter contains an invalid value. For allowed values, check the reference documentation for the Create report or Edit report API endpoints. Also, make sure the request is not configured to omit data from both the parent account and all subaccounts. In other words, if the value of `division_filter_type` is `EXCLUDE_ALL_DIVISIONS`, the value of `sub_account_filter_type` cannot be `EXCLUDE_ALL_SUB_ACCOUNTS`.
400	report_exists	A report with this `display_name` value already exists. Submit another request with a unique `display_name` value.
400	report_format_inapplicable	The report type does not support one or more formats listed in the `format` array. For a list of formats each report type supports, use the List report types endpoint.
400	report_not_found	The report with the given identifier does not exist.
400	invalid_report_type	The `report_type` value is invalid. For a list of allowed `report_type` values, use the List report types endpoint.
401	user_authentication_error	User associated with the API key is inactive, or the API key is missing or invalid.
403	user_forbidden	User missing required permissions.
403	custom_reports_not_enabled	Report Library is not enabled for the account. To request access to the Report Library, contact your DigiCert account manager.
403	report_type_not_found	Specified report type does not exist. To get a list of report types, use the List report types endpoint.
404	no_reports_found	No reports found with display names that match the name provided in your request.
412	json_response_size_exceeds_max	The JSON data for the report is too large to return in the API response. To get the data from this report run, use the Download report endpoint.
412	report_format_inapplicable	Report unavailable in the specified format. To get a list of formats you can request when downloading a generated report, use the Report details endpoint.
412	report_not_generated	Report is still being generated. Try again when the report run `status` is `READY`.

In this section: