API Overview
Quickstart
Make your first DTPR API call in under a minute.
Quickstart
The DTPR API is a public, read-only REST API. No authentication is required. All endpoints support CORS.
Which version?v2 is the current, maintained API and is where new integrations should start — but it publishes only
ai@… schema versions today. The device taxonomy shown below is served by the frozen v1 surface, which is preserved exactly as dtpr.io served it.Base URL
https://api.dtpr.io/api/v1
Get all elements
Fetch every element in the DTPR taxonomy:
curl https://api.dtpr.io/api/v1/elements
const response = await fetch('https://api.dtpr.io/api/v1/elements')
const elements = await response.json()
console.log(elements)
Get elements for a datachain type
Fetch elements filtered to a specific datachain type (e.g., device or ai):
curl https://api.dtpr.io/api/v1/elements/device
const response = await fetch('https://api.dtpr.io/api/v1/elements/device')
const elements = await response.json()
console.log(elements)
Filter by locale
Add the ?locales= query parameter to a typed endpoint to receive only specific languages:
curl "https://api.dtpr.io/api/v1/elements/device?locales=en"
const response = await fetch('https://api.dtpr.io/api/v1/elements/device?locales=en,fr')
const elements = await response.json()
console.log(elements)
Do not add
?locales= to the untyped /api/v1/elements endpoint — it returns 500 Server Error. This is a defect in the frozen v1 surface, reproduced deliberately rather than repaired. The typed element and category endpoints filter correctly.Get categories for a datachain type
curl https://api.dtpr.io/api/v1/categories/device
Get an icon
Icons are served from the same host, namespaced per API version:
curl https://api.dtpr.io/api/v1/icons/identifiable_video.svg
Next steps
- API overview — Versioning, base URLs, and conventions
- v2 reference — The current, maintained API
- Elements reference — Full element schema documentation
- Categories reference — Full category schema documentation
- Concepts: Taxonomy — Understand elements, categories, and datachains
- About DTPR — Learn what DTPR is and who's behind it