Skip to main content
GET
/
v1
/
incidents
/
{id}
curl --request GET \
  --url "https://api.scaling.cloud/v1/incidents/YOUR_INCIDENT_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "orgId": "org_01HX4K9MNPQRST",
    "title": "Payment service elevated error rate",
    "severity": "critical",
    "status": "monitoring",
    "affectedComponents": [
      { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "Payments API" }
    ],
    "createdAt": "2025-04-07T08:23:11.000Z",
    "updatedAt": "2025-04-07T10:41:05.000Z",
    "statusHistory": [
      {
        "id": "sh_01HX4KABCDE001",
        "status": "investigating",
        "changedAt": "2025-04-07T08:23:11.000Z",
        "resolutionNote": null
      },
      {
        "id": "sh_01HX4KABCDE002",
        "status": "identified",
        "changedAt": "2025-04-07T09:15:44.000Z",
        "resolutionNote": null
      },
      {
        "id": "sh_01HX4KABCDE003",
        "status": "monitoring",
        "changedAt": "2025-04-07T10:41:05.000Z",
        "resolutionNote": null
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.scaling.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Retrieves a single incident by its ID. The response includes all incident fields plus a statusHistory array containing every status transition the incident has gone through, in chronological order.
statusHistory surfaces just the lifecycle transitions (investigating → identified → …). For the full timeline — including internal notes, public updates, and redacted entries — call List Incident Updates.

​
Path parameters

​
id
string
required
The UUID of the incident to retrieve.

​
Response

​
data
object
required

​
Error responses

StatusCodeDescription
401not_authorizedMissing or invalid API key.
404not_foundNo incident with the given ID exists in your organization.
500server_errorAn unexpected error occurred on our side.
curl --request GET \
  --url "https://api.scaling.cloud/v1/incidents/YOUR_INCIDENT_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "orgId": "org_01HX4K9MNPQRST",
    "title": "Payment service elevated error rate",
    "severity": "critical",
    "status": "monitoring",
    "affectedComponents": [
      { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "Payments API" }
    ],
    "createdAt": "2025-04-07T08:23:11.000Z",
    "updatedAt": "2025-04-07T10:41:05.000Z",
    "statusHistory": [
      {
        "id": "sh_01HX4KABCDE001",
        "status": "investigating",
        "changedAt": "2025-04-07T08:23:11.000Z",
        "resolutionNote": null
      },
      {
        "id": "sh_01HX4KABCDE002",
        "status": "identified",
        "changedAt": "2025-04-07T09:15:44.000Z",
        "resolutionNote": null
      },
      {
        "id": "sh_01HX4KABCDE003",
        "status": "monitoring",
        "changedAt": "2025-04-07T10:41:05.000Z",
        "resolutionNote": null
      }
    ]
  }
}