---
title: "Retrieve incident detail"
method: GET
path: "/rts/incidents/{incident_id}/"
tags: ["incidents"]
---

# Retrieve incident detail

`GET /rts/incidents/{incident_id}/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/rts/incidents/{incident_id}/`
- 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/:incident_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve incident detail

## Path parameters

- `incident_id` integer, required

## Response `200`

OK

- IncidentObject
  - `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

- `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)