Get an incident | Respan Docs

{
  "incident": {
    "id": "3c9d7e1a-58b2-4f0e-a6d4-91c2b7e3f805",
    "title": "Provider rate limit in prod",
    "environment": "prod",
    "fault_domain": "respan",
    "started_at": "2026-09-30T14:02:00Z",
    "ended_at": "2026-09-30T14:47:00Z",
    "duration_seconds": 2700,
    "data_through_at": "2026-09-30T14:47:00Z",
    "state": "past",
    "resolution_reason": "recovered",
    "severity": "high",
    "trigger": "spike",
    "peak_error_rate": 0.42,
    "baseline_error_rate": 0.012,
    "error_count": 1840,
    "request_count": 9620,
    "hot_bucket_count": 31,
    "error_class_breakdown": {
      "provider_rate_limit": 1702,
      "provider_overloaded": 138
    },
    "dominant_error_class": "provider_rate_limit",
    "dominant_fingerprint": "9F3B2C1D4E5A6B7C",
    "impact": {
      "error_count": 1840,
      "request_count": 9620,
      "error_rate": 0.191,
      "peak_error_rate": 0.42,
      "baseline_error_rate": 0.012,
      "rate_delta": 0.179,
      "rate_multiplier": 15.9,
      "is_estimated": false,
      "affected_customers": 37
    },
    "primary_error": {
      "error_class": "provider_rate_limit",
      "fingerprint": "9F3B2C1D4E5A6B7C"
    },
    "acknowledged_at": null,
    "is_acknowledged": false,
    "notes": "",
    "created_at": "2026-09-30T14:05:12.448210Z",
    "updated_at": "2026-09-30T14:52:03.118604Z"
  },
  "affected": {
    "providers": {
      "unique_count": 1,
      "total_occurrences": 1840,
      "values": [
        {
          "value": "openai",
          "occurrence_count": 1840,
          "percentage": 100,
          "first_seen_at": "2026-09-30T14:02:03.517203",
          "last_seen_at": "2026-09-30T14:46:58.006114"
        }
      ]
    },
    "models": {
      "unique_count": 0,
      "total_occurrences": 0,
      "values": []
    },
    "endpoints": {
      "unique_count": 0,
      "total_occurrences": 0,
      "values": []
    },
    "customers": {
      "unique_count": 37,
      "total_occurrences": 1840,
      "values": []
    }
  },
  "contributors": {
    "items": [
      {
        "fingerprint": "9F3B2C1D4E5A6B7C",
        "title": "provider_rate_limit · openai chat/completions · 429",
        "error_class": "provider_rate_limit",
        "provider": "openai",
        "model": "gpt-4o",
        "endpoint": "chat/completions",
        "status": 429,
        "occurrence_count": 1702,
        "percentage": 92.5,
        "affected_customers": 35,
        "first_seen_at": "2026-09-30T14:02:03.517203",
        "last_seen_at": "2026-09-30T14:46:58.006114",
        "error_group_url": "/api/pulses/errors/9f3b2c1d4e5a6b7c/",
        "drilldown_filters": {
          "start_time": "2026-09-30 14:02:00",
          "end_time": "2026-09-30 14:47:00",
          "environment": "prod"
        }
      }
    ],
    "total_groups": 2,
    "total_occurrences": 1840,
    "other_occurrences": 138
  },
  "occurrence_preview": [],
  "data_status": {
    "is_partial": false,
    "data_through_at": "2026-09-30T14:47:00Z",
    "reason": null
  },
  "links": {
    "timeseries": "/api/pulses/incidents/3c9d7e1a-58b2-4f0e-a6d4-91c2b7e3f805/timeseries/",
    "acknowledgement": "/api/pulses/incidents/3c9d7e1a-58b2-4f0e-a6d4-91c2b7e3f805/acknowledgement/"
  }
}

Returns one incident with exact counts, the error groups behind it, the providers, models, endpoints and customers it hit, and its latest failed requests. Send an empty body.

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

incident_idstringRequired

Incident ID, from List incidents.

Request

This endpoint expects an object.

Response

The incident.

incidentobject

The incident, with exact impact, error_count and request_count, and dominant_fingerprint set from the top error group.

affectedobject

contributorsobject

occurrence_previewlist of objects

The 20 most recent failed requests.

data_statusobject

linksobject

Errors

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error