Developer API Portal

Authentication

The DPP Report API relies on secure Bearer Token mechanics. You can manage your cryptographic API keypairs directly within your enterprise workspace console.

Authorization: Bearer dpp_live_7f92b...a3f

Security Advisory

Never expose your private API tokens in front-end client packages or public repositories. All production requests must execute over secure HTTPS channels.

Rate Limits & SLA

Global rate-limit thresholds based on membership tiers are structured to guarantee high API availability. Requests exceeding limits return HTTP 429 Too Many Requests.

Tier	Limit	Burst Allowance
Standard	1,000 req/min	50 req
Premium Enterprise	10,000 req/min	500 req

GET /v1/verify

Verify Product Passport

Query a specific product ID (DPP ID) to retrieve real-time authenticity status, current owner state, active warranties, and complete ESG sustainability parameters.

Query Parameters

code Required

String (e.g. DPP-ABC-123)

curl -X GET "https://api.dpp.report/v1/verify?code=DPP-ABC-123" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f"

POST /v1/transfer

Initiate Ownership Transfer

Triggers an immutable ownership transfer flow from the current holder to a validated recipient node.

JSON Body Parameters

code Required

String (DPP ID)

recipient_email Required

String (Valid Email)

curl -X POST "https://api.dpp.report/v1/transfer" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "DPP-ABC-123",
    "recipient_email": "newowner@mail.com"
  }'

POST /v1/products

Bulk Product Registration

Registers new product lines alongside mandatory EU ESPR compliance variables (GTIN, recycled metrics, carbon score).

JSON Body Parameters

name Required

String (e.g. Leather Jacket)

gtin Optional

String (8-14 Digits)

curl -X POST "https://api.dpp.report/v1/products" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Eco Series Chronograph",
    "model": "CH-900",
    "gtin": "8681234567890",
    "recycled_content": 45
  }'