Status-Code
Returns exact status-code distribution by endpoint for debugging client errors, rate limits, and server failures. Metrics include API-key-authenticated Developer API traffic only; dashboard sessions, admin routes, hosted public flows, OAuth callbacks, inbound provider webhooks, health checks, and the metrics endpoints themselves are excluded.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Query Params
fromOptionalstring
Start timestamp in RFC3339 format. Defaults to 7 days before now.
toOptionalstring
End timestamp in RFC3339 format. Defaults to now. The maximum raw range is 90 days.
methodOptionalstring
Filter by HTTP method.
ValuesGET | POST | PUT | PATCH | DELETE
pathOptionalstring
Filter by normalized endpoint path, such as
/v1/posts/:id/publish.status_classOptionalstring
Filter by HTTP status class.
Values2xx | 3xx | 4xx | 5xx
limitOptionalinteger
Maximum rows for list endpoints. Defaults to 50, maximum 200.
Response Body
200
data[]array
Status-code distribution rows ordered by total call count.
data[].status_codenumber
Exact HTTP response status code.
data[].methodstring
HTTP method for the endpoint.
data[].pathstring
Normalized API route path.
data[].total_callsnumber
Number of matching responses for this status, method, and path.
400
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
401
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
Related Endpoints
GET/v1/api-metrics/overall for aggregate totals.
GET/v1/api-metrics/summary for per-endpoint latency and error rows.
GET/v1/api-metrics/trend for hourly or daily chart buckets.
GET/v1/api-metrics/status-codes for exact status-code distribution.
Trend error_count uses the same 4xx-plus-5xx definition as error_rate_pct; 429 responses are also exposed separately through rate_limited_count.