Skip to navigation
API ReferenceObservabilityErrors

List error groups

Lists failed spans grouped by fingerprint, most failures first, with each group’s reach and triage state. Counts come from a rollup refreshed every 10 minutes, so the range is widened to whole hours.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request

This endpoint expects an object.
start_timedatetimeOptional
Start of the range, ISO 8601. A time without an offset is read as UTC. Defaults to 7 days ago, which is also used if the value can't be parsed.
end_timedatetimeOptional
End of the range, ISO 8601. A time without an offset is read as UTC. Defaults to now, which is also used if the value can't be parsed.
environmentstringOptional

Only count spans from this environment, such as prod or test. Omit it to include every environment.

error_classenumOptional

Only this error class. For several values or is not, use filters.

fault_domainenumOptional

Only errors with this fault. none selects client cancellations.

Allowed values:
providerstringOptional
Only errors from this provider ID.
statusintegerOptional
Only errors with this HTTP status code.
filtersobjectOptional

Narrow the errors with the same filter shape as the Logs filter bar. Only these four keys are accepted; any other key is a 400.

Response

Error groups for the range.
issueslist of objects
Up to 200 error groups, most failures first. There is no pagination.
total_issuesinteger
Error groups in the range, including any past the first 200.
total_errorsinteger
Failed spans across all groups in the range.

Errors

400
Bad Request Error
403
Forbidden Error
429
Too Many Requests Error