Skip to main content
GET
/
v1
/
incidents
curl --request GET \
  --url "https://api.scaling.cloud/v1/incidents?status=investigating&severity=critical&limit=10" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "incidents": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "orgId": "org_01HX4K9MNPQRST",
        "title": "Payment service elevated error rate",
        "severity": "critical",
        "status": "investigating",
        "affectedComponents": [
          { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "Payments API" }
        ],
        "createdAt": "2025-04-07T08:23:11.000Z",
        "updatedAt": "2025-04-07T08:23:11.000Z"
      },
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "orgId": "org_01HX4K9MNPQRST",
        "title": "API gateway latency spike",
        "severity": "high",
        "status": "investigating",
        "affectedComponents": [],
        "createdAt": "2025-04-07T07:55:42.000Z",
        "updatedAt": "2025-04-07T07:55:42.000Z"
      }
    ],
    "nextCursor": "eyJpZCI6ImIyYzNkNGU1LWY2YTctODkwMSJ9"
  }
}

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 all incidents belonging to your organization. Results are returned in reverse chronological order (newest first) and can be filtered by status, severity, or date range. Use the cursor parameter to paginate through large result sets.

​
Query parameters

​
status
string
Filter by incident status. One of investigating, identified, monitoring, or resolved.
​
severity
string
Filter by incident severity. One of critical, high, medium, or low.
​
from
string
Return incidents created on or after this date. ISO 8601 date format (e.g. 2025-01-01).
​
to
string
Return incidents created on or before this date. ISO 8601 date format (e.g. 2025-12-31).
​
limit
number
default:"20"
Maximum number of incidents to return per page. Must be between 1 and 100.
​
cursor
string
Pagination cursor returned by the previous response as nextCursor. Omit to fetch the first page.

​
Response

​
data
object
required

​
Error responses

StatusCodeDescription
401not_authorizedMissing or invalid API key.
500server_errorAn unexpected error occurred on our side.
curl --request GET \
  --url "https://api.scaling.cloud/v1/incidents?status=investigating&severity=critical&limit=10" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "incidents": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "orgId": "org_01HX4K9MNPQRST",
        "title": "Payment service elevated error rate",
        "severity": "critical",
        "status": "investigating",
        "affectedComponents": [
          { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "Payments API" }
        ],
        "createdAt": "2025-04-07T08:23:11.000Z",
        "updatedAt": "2025-04-07T08:23:11.000Z"
      },
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "orgId": "org_01HX4K9MNPQRST",
        "title": "API gateway latency spike",
        "severity": "high",
        "status": "investigating",
        "affectedComponents": [],
        "createdAt": "2025-04-07T07:55:42.000Z",
        "updatedAt": "2025-04-07T07:55:42.000Z"
      }
    ],
    "nextCursor": "eyJpZCI6ImIyYzNkNGU1LWY2YTctODkwMSJ9"
  }
}