---
title: "Citizen Sensors Urban Score"
method: POST
path: "/api/v1/citizen-sensors/urban-score"
tags: ["Smart Citizen Sensors"]
---

# Citizen Sensors Urban Score

`POST /api/v1/citizen-sensors/urban-score`

## Request

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

Compute urban livability score from multi-parameter data.

Combines air quality (PM2.5 AQI), noise (WHO compliance),
light (natural availability), and temperature comfort into
a single 0-100 livability score with per-dimension breakdown.

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

Parameters (JSON body):
- device_id: int -- Smart Citizen device ID
- hours: int -- Hours of data to average (default 24)
- readings: dict -- Optional: provide averaged readings directly
  (keys: pm25, noise_dba, light_lux, temperature)

## Query parameters

- `x_api_key` string, nullable

## Request body

- object

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