REST API (v2)

GET /schemas/:version/elements/:element_id

Point read for a single element by id.

Default projection is all. Inspect icon_variants for the variant keys valid in composed-icon URLs.

Summary

Return a single element's full record, including its icon_variants array.

Request

GET https://api.dtpr.io/api/v2/schemas/:version/elements/:element_id

Param	In	Default	Description
`version`	path	—	Canonical version.
`element_id`	path	—	Whitelisted to `[a-zA-Z0-9_-]`.
`locales`	query	—	Comma-separated locale codes.
`fields`	query	`all`	Comma-separated field list or `all`.

Response

HTTP/1.1 200 OK
Content-Type: application/json
DTPR-Content-Hash: sha256-…
Cache-Control: no-store

{
  "ok": true,
  "version": "dtpr@2026-09-01-beta",
  "element": {
    "id": "organization",
    "title": [{"locale":"en","value":"Organization"}],
    "description": [{"locale":"en","value":"A company, nonprofit, or other non-government organization."}],
    "category_id": "accountable",
    "symbol_id": "building",
    "icon_variants": ["default", "dark", "vendor", "vendor.dark", "deployer", "deployer.dark"],
    "variables": []
  }
}

Errors

Code	HTTP	Meaning
`bad_request`	400	Malformed `:version` or `:element_id`.
`not_found`	404	Version or element not registered.

Example

curl -s "https://api.dtpr.io/api/v2/schemas/dtpr@2026-09-01-beta/elements/organization?locales=en"

GET /api/v2/schemas/dtpr@2026-09-01-beta/elements/organization HTTP/1.1
Host: api.dtpr.io