# Urban Observatory API (Urban Sciences Building) — Timeseries

**Canonical:** https://apis.io/apis/newcastle/urban-observatory-timeseries/  
**Provider:** Newcastle University — https://apis.io/providers/newcastle/  
**Base URL:** https://api.usb.urbanobservatory.ac.uk/api/v2.0a  
**Documentation:** https://api.usb.urbanobservatory.ac.uk/

Urban Observatory API (Urban Sciences Building) — Timeseries is one of 8 APIs that [Newcastle University](https://apis.io/providers/newcastle/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Time Series, Smart Cities, and Open Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

There may be more than one timeseries associated with a feed. Ordinarily there will be a plain timeseries representing raw data from the device; in some cases there may be additional timeseries representing converted, corrected or temporally aggregated values.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2.0a/sensors/timeseries/{id}` | Request a single timeseries by its unique ID |
| GET | `/api/v2.0a/sensors/timeseries/{id}/historic` | Request historic data from a timeseries by its unique ID and a date range |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/openapi/newcastle-timeseries-api-openapi.yml
- **Documentation** — https://api.usb.urbanobservatory.ac.uk/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-schema/newcastle-timeseries-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-schema/newcastle-timeseriesentry-schema.json
- **x-vocabulary** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/vocabulary/newcastle-vocabulary.yml
- **x-rules** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/rules/newcastle-rules.yml
- **x-json-ld** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-ld/newcastle-context.jsonld
- **x-examples** — https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/examples/newcastle-timeseries-entry-example.json
- **Website** — https://urbanobservatory.ac.uk/

## Other Newcastle University APIs (7)

- [Digitised Objects Repository Search and Data API](https://apis.io/apis/newcastle/digitised-objects/)
- [ECPPEC Electoral Data GraphQL API](https://apis.io/apis/newcastle/ecppec/)
- [Newcastle University eTheses OAI-PMH Endpoint](https://apis.io/apis/newcastle/etheses-oai/)
- [data.ncl Research Data Repository (Figshare tenancy)](https://apis.io/apis/newcastle/data-ncl/)
- [Urban Observatory API (Urban Sciences Building) — Entity](https://apis.io/apis/newcastle/urban-observatory-entity/)
- [Urban Observatory API (Urban Sciences Building) — Feed](https://apis.io/apis/newcastle/urban-observatory-feed/)
- [Urban Observatory API (Urban Sciences Building) — Summary](https://apis.io/apis/newcastle/urban-observatory-summary/)

## Tags

Time Series, Smart Cities, Open Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/newcastle/urban-observatory-timeseries/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/newcastle/.