API Overview
API Overview
The DTPR API provides read-only access to the DTPR taxonomy — elements, categories, and datachain types that describe data-collecting technologies in public spaces.
Base URL
https://dtpr.io/api/dtpr/v1
Versioning
The API is versioned using a path prefix (/v1). The current stable version is v1.
When breaking changes are introduced, a new version will be created (e.g., /v2 or a datestamp like /2026-06). Older versions will continue to be served but may be deprecated.
Authentication
The API is public and requires no authentication. All endpoints are read-only.
CORS
All /api/** endpoints have CORS enabled, so you can call them directly from browser-side JavaScript.
Locale filtering
All endpoints support an optional locales query parameter to filter localized content:
?locales=en
?locales=en,fr,es
When provided, only locale entries matching the requested codes are included in the response. When omitted, all available locales are returned.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/dtpr/v1/elements | All elements across all datachain types |
GET | /api/dtpr/v1/elements/{datachain_type} | Elements filtered by datachain type |
GET | /api/dtpr/v1/categories/{datachain_type} | Categories for a datachain type |
The datachain_type parameter must be one of the supported types: device, ai.
Response format
All responses are JSON. Element endpoints return arrays of element objects; category endpoints return arrays of category objects. See the v1 reference for full schema details.