DPP API

Digital Product Passport API

Issue ESPR-aligned textile-dpp v1 passports via REST. Prefer external_sku — no VinKet inventory required. Legal compliance remains the brand's responsibility. Base URL: https://www.vinket.eu/api/v1/dpp

← Back to KadmilOS API overview · Product page

Same as all KadmilOS endpoints — pass your kos_live_* key and ensure the dpp module is enabled (DPP-only or DPP+Eco bundle).

header

Authorization: Bearer kos_live_YOUR_KEY

Authentication

Same as all KadmilOS endpoints — pass your kos_live_* key and ensure the dpp module is enabled (DPP-only or DPP+Eco bundle).

header

Authorization: Bearer kos_live_YOUR_KEY

Create a passport

POST materials, brand, category, and origin. Response is textile-dpp v1 JSON. Schema v2 is roadmap. Brand owns ESPR legal validation.

POST /api/v1/dpp

curl -sS -X POST https://www.vinket.eu/api/v1/dpp \
  -H "Authorization: Bearer $KADMILOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_sku": "SKU-2024-001",
    "brand": "Your Brand",
    "category": "trousers",
    "materials": [{"name": "cotton", "pct": 98}, {"name": "elastane", "pct": 2}],
    "origin_country": "IT"
  }'

Retrieve passports

Query by external_sku or passport id. Use for PDP display, buyer portals, and circular-economy reuse/repair data trails.

GET

curl -sS "https://www.vinket.eu/api/v1/dpp?external_sku=SKU-2024-001" \
  -H "Authorization: Bearer $KADMILOS_KEY"

Export QR / NFC

Call /export for a QR URL and NFC NDEF payload so the passport travels with the garment.

GET /export

curl -sS "https://www.vinket.eu/api/v1/dpp/{id}/export" \
  -H "Authorization: Bearer $KADMILOS_KEY"

Key fields

external_sku — preferred SKU key (no VinKet inventory)
materials — composition array with name + pct
origin_country — ISO country code
Schema: textile-dpp v1 — ESPR-aligned, not a legal compliance certificate