API v1 Overview

API v1 provides three endpoints for accessing the DTPR taxonomy:

Endpoints

GET /api/dtpr/v1/elements

Returns all elements across all datachain types.

Query parameters:

• locales (optional) — Comma-separated locale codes to filter localized content

Response: Array of element objects (see Elements)

GET /api/dtpr/v1/elements/:datachain_type

Returns elements filtered to a specific datachain type.

Path parameters:

• datachain_type (required) — Must be device or ai

Query parameters:

• locales (optional) — Comma-separated locale codes to filter localized content

Response: Array of element objects (see Elements)

GET /api/dtpr/v1/categories/:datachain_type

Returns categories for a specific datachain type, sorted by display order.

Path parameters:

• datachain_type (required) — Must be device or ai

Query parameters:

• locales (optional) — Comma-separated locale codes to filter localized content

Response: Array of category objects (see Categories)

Common patterns

All v1 endpoints share these behaviors:

• Locale arrays — User-facing text is returned as arrays of { locale, value } objects
• Schema metadata — Each object in the response includes a schema section with name, id, version, and namespace
• Version timestamps — Elements and categories include ISO 8601 version timestamps calculated from the latest update across all locales
• Variable inheritance — Elements inherit variables defined at the category level