---
title: "Retrieve sensor list"
method: GET
path: "/sensors/"
tags: ["sensor"]
---

# Retrieve sensor list

`GET /sensors/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/sensors/`
- 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: `sensor_access`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/sensors/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Returns sensor list.

- SensorListResponse
  - `count` integer, required: Count of all sensors
  - `next` string, uri, nullable, required: Next page from pagination
  - `previous` string, uri, nullable, required: Previous page from pagination
  - `results` SensorObject[], required: List of sensors owned by the user
    - `id` integer, required: Sensor ID
    - `user` integer, required: User ID
    - `name` string, required: Sensor name
    - `type` 'motion' | 'camera_motion' | 'door_window' | 'smoke' | 'fire' | 'glass_break' | 'shock_vibration' | 'water' | 'perimeter_entry', required: Sensor type
    - `placement` 'indoors' | 'outdoors', required: Sensor placement
    - `manufacturer` string, required: Sensor manufacturer
    - `model` string, required: Sensor model
    - `note` string, required: Any note related to sensor
    - `hash` string, required: Event API hash (a unique token for each sensor)
    - `email` string, required: Unique email address that can be used to receive events from this sensor by Angelcam
    - `enabled` boolean, required: Defaults to True. Indicates if sensor is enabled or not. If disabled then all events from this sensor are ignored.
    - `override_arming` boolean, required: Defaults to False. If enabled, an event received from the sensor will always trigger an incident regardless of the arming settings.
    - `camera` integer, required: Camera ID sensor is bind to
    - `enable_cloud_recording_for` 'PT30S' | 'PT1M' | 'PT2M' | 'PT5M', duration, required: Duration of event Recording triggered by an event from this sensor. This setting is applied only if sensor has an assigned camera with active Cloud Recording.
    - `incident_delay` string, duration, required: A delay before RTS incident is triggered. If the location is disarmed during this period, no incident is forwarded. However the video from the binded camera is recorded. PT0S means no delay and PT3M is the max.
    - `created_at` string, required: DateTime when sensor was created
    - `updated_at` string, required: DateTime when sensor was last updated
    - `events_count_ifttt` integer, required: Total count of events received from this sensor via IFTTT
    - `events_count_email` integer, required: Total count of events received from this sensor via email
    - `events_count_api` integer, required: Total count of events received from this sensor via API

## Other responses

- `400`: Query params are invalid.
- `401`: Missing or invalid authorization.
- `403`: Missing permission.

---

[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/dd1cdc3f2c23?raw)