GET - List Incidents

Returns Incidents belonging to the API key's organization.

Request

• Method: GET
• Endpoint: /incidents
• Operation ID: list-incidents

GET https://api.targpatrol.com/api/v1/incidents?priority=in:MAJOR,CRITICAL&tags=in:safety&startAt=gte:2026-08-01T00:00:00Z&limit=20&offset=0
x-api-key: {your_external_api_key}

Query parameters

Name	Required	Description
limit	no	Maximum number of items to return
offset	no	Number of items to skip
sort	no	Sort by id, name, priority, occurredAt, createdAt, or lastModifiedAt
q	no	Quick search across Incident name and tags
typeId	no	Filter by Type IDs, for example in:{uuid}
categoryId	no	Filter by Category IDs
stateId	no	Filter by workflow state IDs
priority	no	Filter by MINOR, NORMAL, MAJOR, or CRITICAL
locationId	no	Filter by Location IDs
pointId	no	Filter by Point IDs
assigneeId	no	Filter by assignee IDs
createdBy	no	Filter by reporter IDs
startAt	no	Lower bound of lastModifiedAt, for example gte:2026-08-01T00:00:00Z
endAt	no	Upper bound of lastModifiedAt, for example lte:2026-08-31T23:59:59Z
tags	no	Filter by one or more tags, for example in:safety,broken-window

Multiple values use the standard in:value1,value2 filter syntax.

Response

200 OK

{
  "data": [
    {
      "id": "4adbc000-3095-42f3-bddd-d8a1da1ab2bd",
      "name": "Broken lobby window",
      "stateId": "1e86aa2d-717a-46db-a73b-c760fb44869d",
      "priority": "MAJOR",
      "locationId": "20553a15-51df-4266-88c2-1067c2d1f0e8",
      "occurredAt": "2026-08-13T09:30:00.000Z",
      "mediaIds": [],
      "tags": ["safety", "broken-window"]
    }
  ],
  "meta": {
    "offset": 0,
    "limit": 20,
    "count": 1,
    "sort": null,
    "filter": []
  }
}

Each item uses the complete IncidentResponse schema.

Other responses: 401 Unauthorized, 500 Internal Server Error.