---
title: "POST /v2/{org_id}/sensors/"
method: POST
path: "/v2/{org_id}/sensors/"
tags: ["Sensors - By Org"]
---

# POST /v2/{org_id}/sensors/

`POST /v2/{org_id}/sensors/`

List sensors for an organization

## Request body

- SensorList
  - `serial_number` string, required
  - `uuid` string, nullable
  - `organization_id` integer, required
  - `doorway_id` integer
  - `doorway_name` string
  - `sensor_type` string, required
  - `device_function` string
  - `kind` string
  - `hardware_model` string
  - `is_virtual` string
  - `is_simulated` string
  - `status` 'unconfigured' | 'online' | 'error' | 'low_power' | 'archived'
  - `last_heartbeat` string, date-time
  - `current_disposition` string
  - `network_addresses` string
  - `firmware_version` string
  - `latest_config_change` string
  - `operating_system` string
  - `plan_sensor_id` string
  - `plan_sensor_plan_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `space_ids` string

## Response `201`

Created

- OptionalSensorListSerializer
  - `serial_number` string, required
  - `uuid` string, nullable
  - `organization_id` integer, required
  - `doorway_id` integer
  - `doorway_name` string
  - `sensor_type` string, required
  - `device_function` string
  - `kind` string
  - `hardware_model` string
  - `is_virtual` string
  - `is_simulated` string
  - `status` 'unconfigured' | 'online' | 'error' | 'low_power' | 'archived'
  - `last_heartbeat` string, date-time
  - `current_disposition` string
  - `network_addresses` string
  - `firmware_version` string
  - `latest_config_change` string
  - `operating_system` string
  - `plan_sensor_id` string
  - `plan_sensor_plan_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `space_ids` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.dev/density/apis/your-project-api.md) · [All operations](https://skmtc.dev/density/apis/your-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/density/your-project-api/revisions/eab10fe035e6/schema)