---
title: "Retrieve incidents"
method: GET
path: "/rts/incidents/"
tags: ["incidents"]
---

# Retrieve incidents

`GET /rts/incidents/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/rts/incidents/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `incidents_access`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/rts/incidents/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves list of user incidents

## Query parameters

- `limit` integer
- `offset` integer
- `start` string, date-time
- `end` string, date-time
- `ordering` 'asc' | 'desc'

## Response `200`

OK

- IncidentListResponse
  - `count` integer, required: Count of all incidents
  - `next` string, uri, nullable, required: Next page from pagination
  - `previous` string, uri, nullable, required: Previous page from pagination
  - `results` IncidentObject[], required: List of incidents
    - `id` number, required: Incident ID
    - `created_at` string, required: Time when incident was created, format `%Y-%m-%dT%H:%M:%SZ`
    - `verified_at` string, nullable, required: Time when incident was verified, format `%Y-%m-%dT%H:%M:%SZ`
    - `closed_at` string, nullable, required: Time when incident was closed, format `%Y-%m-%dT%H:%M:%SZ`
    - `first_event_occurred_at` string, nullable, required: Time when first event (triggering one) occured, format `%Y-%m-%dT%H:%M:%SZ`
    - `last_event_occurred_at` string, nullable, required: Time when last event durign of incident occured, format `%Y-%m-%dT%H:%M:%SZ`
    - `event_count` number, required: Number of events during incident
    - `incident_sharing_url` string, nullable, required: URL that can be used for incident verification by third parties. The URL leads to a web page where all cameras from the affected location can be viewed (live streams + the last two hours of recording). The URL is valid for one hour after the corresponding incident is created. This field will be `null` if the URL is no longer valid.
    - `snapshot` SnapshotObject, nullable, required: Snapshot is created by Angelcam when certain types of events are received
      - `url` string, uri, nullable, required: URL of the snapshot image
      - `created_at` string, date-time, required: The date and time when the snapshot was created for the first time

## Other responses

- `400`: Query params are invalid.
- `401`: Missing or invalid authorization.
- `403`: Missing permission.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/angelcam/apis/angelcam-api.md) - [All operations](https://skmtc.dev/angelcam/apis/angelcam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/angelcam/apis/angelcam-api/revisions/a3b9b1d3e96a?raw)