Get incident

GET

/incidents/{incidentId}

Fetch the current state of an incident. Use this to poll status updates.
For real-time updates, we recommend webhooks instead.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Incident object

Body

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/incidents/inc_a1b2c3d4e5f6g7h8' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "incident": {
        "incident_id": "inc_a1b2c3d4e5f6g7h8",
        "idempotency_key": "string",
        "category": "sos",
        "severity": "low",
        "status": "created",
        "subject": {
            "name": "Amaka Obi",
            "phone": "+2348012345678",
            "email": "[email protected]",
            "reference": "TRIP-44821",
            "metadata": {
                "vehicle_plate": "LND-204-KJA",
                "driver_name": "Olu Babs"
            }
        },
        "title": "string",
        "description": "string",
        "location": {
            "coordinates": [
                3.3792,
                6.5244
            ],
            "address": "14 Bourdillon Road, Ikoyi, Lagos",
            "landmark": "Gate B — North entrance"
        },
        "resolution_outcome": "handled",
        "resolution_notes": "string",
        "is_drill": true,
        "timeline": [
            {
                "status": "string",
                "event": "created",
                "message": "string",
                "timestamp": "2019-08-24T14:15:22.123Z"
            }
        ],
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "resolved_at": "2019-08-24T14:15:22.123Z",
        "cancelled_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-03-10 02:58:15

List incidents

Cancel incident