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
}
]
}
}
{
"statusCode": 401,
"type": "not_authorized_error",
"code": "not_authorized",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 404,
"type": "invalid_request_error",
"code": "not_found",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 500,
"type": "invalid_error",
"code": "server_error",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
Incidents
Get Incident
Returns a single incident including its full status history.
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
}
]
}
}
{
"statusCode": 401,
"type": "not_authorized_error",
"code": "not_authorized",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 404,
"type": "invalid_request_error",
"code": "not_found",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 500,
"type": "invalid_error",
"code": "server_error",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
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
The UUID of the incident to retrieve.
Response
Hide properties
Hide properties
Unique identifier for the incident (UUID).
The organization this incident belongs to.
Short title describing the incident.
Severity level:
critical, high, medium, or low.Current lifecycle status:
investigating, identified, monitoring, or resolved.Components affected by this incident. Each entry has
id and name. Empty array if none.ISO 8601 timestamp of when the incident was created.
ISO 8601 timestamp of when the incident was last updated.
Ordered list of all status transitions, from oldest to newest.
Show StatusHistoryEntry properties
Show StatusHistoryEntry properties
Unique identifier for this history entry.
The status that was set at this point:
investigating, identified, monitoring, or resolved.ISO 8601 timestamp of when this transition occurred.
Optional note recorded at the time of the transition. Most commonly set when transitioning to
resolved. null if no note was recorded.Error responses
| Status | Code | Description |
|---|---|---|
401 | not_authorized | Missing or invalid API key. |
404 | not_found | No incident with the given ID exists in your organization. |
500 | server_error | An 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
}
]
}
}
{
"statusCode": 401,
"type": "not_authorized_error",
"code": "not_authorized",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 404,
"type": "invalid_request_error",
"code": "not_found",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
{
"statusCode": 500,
"type": "invalid_error",
"code": "server_error",
"requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
}
⌘I