Sety
  1. Incidents
Sety
  • Developer API Reference
  • Health
    • Health check
      GET
  • Incidents
    • Create incident
      POST
    • List incidents
      GET
    • Get incident
      GET
    • Cancel incident
      POST
    • Add note
      POST
  • Access Logs
    • List access logs
      GET
    • Access log stats
      GET
    • Create access log
      POST
    • Get current visitors
      GET
    • Checkout visitor
      PATCH
  • Threat Intelligence
    • List danger zones
      GET
    • Danger analytics for a location
      GET
    • Heatmap data
      GET
    • Safety score
      GET
    • Route safety analysis
      GET
  • Schemas
    • Error
    • PaginatedResponse
    • GeoPoint
    • Subject
    • Location
    • IncidentLocation
    • SLA
    • IncidentTimelineEvent
    • ResponderAssignment
    • TimelineEvent
    • Incident
    • CreateIncidentRequest
    • IncidentAnalytics
    • AccessCode
    • CreateAccessCodeRequest
    • ValidationResult
    • AccessLog
    • CurrentVisitor
    • DangerAnalytics
    • HeatmapResponse
    • SafetyScore
    • TimeAnalysis
    • LocationComparison
    • RouteSafety
    • RiskPrediction
    • IncidentPatterns
    • SafeZones
    • ApiKey
    • CreateApiKeyRequest
    • WebhookEndpoint
    • WebhookDelivery
  1. Incidents

List incidents

GET
/incidents
Returns all incidents created by your organization, newest first.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200
application/json
Paginated incidents
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/incidents?status&category&severity&from_date&to_date&page&limit' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "page": 0,
    "limit": 0,
    "totalPages": 0,
    "totalResults": 0,
    "results": [
        {
            "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
Previous
Create incident
Next
Get incident
Built with