Skip to navigation
API ReferenceObservabilityErrors

Get an error group

Returns one error group’s counts, first and last seen, reach and triage state in a time range, with its most recent failed spans.

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.

Path parameters

fingerprintstringRequired

Error group fingerprint from List error groups: 16 uppercase hex characters, case-sensitive.

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.

limitintegerOptional1-500Defaults to 50

Most recent failures to return in occurrences. Values above 500 are capped at 500.

Response

The error group.
fingerprintstring

Error group ID: a hash of error class, provider, endpoint and status code. 16 uppercase hex characters.

titlestring

Readable name: error class, provider and endpoint, and status code.

error_classenum
Normalized cause of the failure, assigned when the span is stored.
fault_domainenum

Whose fault the failure is, derived from error_class: user (your requests or your own provider keys), provider (the upstream provider), respan (Respan's gateway or managed capacity), or none (client cancellations).

Allowed values:
levelenum

Respan's ops alert level for the error class: ops_page for errors Respan pages its on-call for, ops_log for the rest, none for cancellations.

Allowed values:
providerstring
Provider ID.
endpointstring

Upstream operation, such as chat/completions, responses or embeddings.

statusinteger
HTTP status code.
countinteger
Failed spans in the group in the time range.
first_seenstring
First failure in the range. UTC, ISO 8601 without a timezone suffix.
last_seenstring
Latest failure in the range. UTC, ISO 8601 without a timezone suffix.
affected_customersinteger

Distinct customer_identifier values among the failures. Spans without one count as one value.

affected_modelsinteger
Distinct models among the failures.
resolutionenum

Triage state. Groups you haven't triaged are unresolved.

Allowed values:
occurrenceslist of objects
Most recent failures in the group, newest first.

Errors

403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error