List 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"
  }
}

{
  "statusCode": 401,
  "type": "not_authorized_error",
  "code": "not_authorized",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

{
  "statusCode": 500,
  "type": "invalid_error",
  "code": "server_error",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

GET

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"
  }
}

{
  "statusCode": 401,
  "type": "not_authorized_error",
  "code": "not_authorized",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

{
  "statusCode": 500,
  "type": "invalid_error",
  "code": "server_error",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

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).

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

Hide properties

incidents

Incident[]

required

Array of incident objects for the current page.

Show Incident properties

string

required

Unique identifier for the incident (UUID).

orgId

string

required

The organization this incident belongs to.

title

string

required

Short title describing the incident.

severity

string

required

Severity level: critical, high, medium, or low.

status

string

required

Current lifecycle status: investigating, identified, monitoring, or resolved.

affectedComponents

array of object

required

Components affected by this incident. Each entry has id and name. Empty array if none.

createdAt

string

required

ISO 8601 timestamp of when the incident was created.

updatedAt

string

required

ISO 8601 timestamp of when the incident was last updated.

nextCursor

string | null

required

Cursor to pass as cursor on your next request to fetch the following page. null when there are no more results.

Error responses

Status	Code	Description
`401`	`not_authorized`	Missing or invalid API key.
`500`	`server_error`	An 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"
  }
}

{
  "statusCode": 401,
  "type": "not_authorized_error",
  "code": "not_authorized",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

{
  "statusCode": 500,
  "type": "invalid_error",
  "code": "server_error",
  "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}

Errors Create Incident

Overview

Incidents

On-call Schedules

Escalation Policies

Routing Policies

Working Hours

Team

Query parameters

Response

Error responses

​Query parameters

​Response

​Error responses

Query parameters

Response

Error responses