---
title: "Citizen Sensors Readings"
method: GET
path: "/api/v1/citizen-sensors/readings"
tags: ["Smart Citizen Sensors"]
---

# Citizen Sensors Readings

`GET /api/v1/citizen-sensors/readings`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/citizen-sensors/readings`
- Auth: none declared

Get multi-parameter environmental readings from a device.

Fetches historical data for all available sensors on the device
(temperature, humidity, noise, light, PM2.5, PM10, pressure,
battery, etc.) with hourly aggregation.

Returns time series for each parameter keyed by sensor name.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `device_id` integer, required: Smart Citizen device ID
- `hours` integer: Hours of historical data (1-720, default 24)
- `x_api_key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)