Arkive Product Passport API
RESTful JSON API for creating and managing Digital Product Passports (DPPs) across industries such as beauty, automotive, personal care, fragrances, and chemicals. Each passport contains verified data, enabling full product transparency — from materials to marketing claims.
Overview
The Arkive API allows you to generate a Digital Product Passport that automatically creates a QR code. This QR code can be exported and printed on packaging, allowing B2B and B2C markets to scan and view verified data such as CO₂ emissions, materials, certificates, and brand information.
The passport model is designed to meet upcoming EU regulations and supports the full chemical and materials chain — from components to finished products.
Base URL: https://api.arkive.com/v1/passports
Authentication
All endpoints are secured using an API key passed via the Authorization header:
Authorization: Bearer YOUR_API_KEY
API keys are provided to partners and enterprise customers prior to launch.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /passports | Create or update a product passport (upsert) |
GET | /passports/{product_id}/{batch_id} | Retrieve passport data (DPP + LCA + QR) |
DELETE | /passports/{product_id}/{batch_id} | Remove a product passport permanently |
Data Model
Each passport represents a verified digital identity for a product. It contains mandatory and optional attributes that are extensible across industries — beauty, automotive, chemicals, and more. During integration, Arkive aligns the data model with your existing systems or provides an integration service if a direct match isn’t possible.
[PRODUCT_PASSPORT]
|-- product_id (string)
|-- batch_id (string)
|-- brand_information (object)
|-- product_identification (object)
|-- environmental_footprint (object)
|-- marketing_statements (array)
|-- certificates (array)
|-- qr_code_url (string)
|-- whitelabel (boolean)
Mandatory Fields
| Attribute | Type | Description |
|---|---|---|
| product_id | string | Unique product identifier (e.g. SKU-12345) |
| batch_id | string | Unique batch or production lot identifier |
| economic_operator_name | string | Legal manufacturer or importer |
| brand_information | object | Brand data including name, short bio, and logo (publicly shown in the QR code) |
| ean_code | string | EAN/UPC code |
| product_name | string | Commercial product name |
| product_category | string | Main category (e.g. Personal Care, Automotive) |
| manufacturing_date | date | Production date (YYYY-MM-DD) |
| functional_unit.weight | float | Weight or volume |
| functional_unit.unit | string | Measurement unit (e.g. kg, L, piece) |
Environmental & Material Data
Each passport includes an environmental_footprint object containing lifecycle assessment (LCA) data and material composition.
This allows for full traceability of ingredients, components, and raw materials throughout the supply chain.
"environmental_footprint": {
"lifecycle_stage": "Manufacturing",
"material_composition": {
"ingredients": [
{ "name": "Lavender Extract", "origin": "France", "percentage": 0.05 },
{ "name": "Water", "origin": "EU", "percentage": 0.80 }
],
"packaging": [
{ "material": "Glass", "quantity_per_functional_unit": 0.2 }
]
},
"emissions_lca": {
"co2e_total": 1.42,
"unit": "kg CO₂e"
}
}
Marketing Statements & Certificates
Products can include marketing claims such as “natural”, “organic”, “made in France”, or “recyclable”. These must be supported by certificates. Therefore, certificates are mandatory if marketing statements are provided.
"marketing_statements": [
"organic",
"vegan",
"made in France"
],
"certificates": [
{
"name": "EcoCert Organic",
"file_url": "https://arkive.com/certificates/EcoCert.pdf",
"validated": true
}
]
More verified data increases consumer reliability and trust scores within the Arkive network.
QR Code Generation
Every passport automatically generates a unique QR code when created. The QR code is not optional — it is a core output of the product passport. You can export it and place it on packaging for consumers or partners to scan.
"qr_code_url": "https://api.arkive.com/v1/passports/SKU-12345/KA8-2005/qr"
When scanned, the QR reveals product data including CO₂ emissions, certificates, brand bio, and verified marketing claims.
White-Label Option
The product passport can be white-labeled for enterprises who wish to present their own identity while using Arkive’s verification and data infrastructure.
"whitelabel": true
Integration & Data Services
API connection is required for automation. If your internal data model is not aligned with Arkive’s attributes, an integration service is provided. This may include data mapping, system connection, and LCA alignment — subject to an integration fee.
If you do not have LCA data or certificates available, Arkive can provide or verify them. This increases the overall integration time but ensures full compliance and transparency.
Example Payload
{
"product_identification": {
"product_id": "SKU-12345",
"batch_id": "KA8-2005",
"economic_operator_name": "Arkive Labs",
"brand_information": {
"brand_name": "Arkive Beauty",
"bio": "Modern skincare powered by data transparency.",
"logo_url": "https://arkive.nl/assets/brand-logo.svg"
},
"ean_code": "0655439008006",
"product_name": "Lavender Hand Cream",
"product_category": "Personal Care/Skincare",
"manufacturing_date": "2024-06-15",
"functional_unit": { "weight": 1.0, "unit": "kg" }
},
"environmental_footprint": {
"lifecycle_stage": "Manufacturing",
"material_composition": {
"ingredients": [
{ "name": "Lavender Extract", "origin": "France", "percentage": 0.05 },
{ "name": "Water", "origin": "EU", "percentage": 0.80 }
],
"packaging": [
{ "material": "Glass", "quantity_per_functional_unit": 0.2 }
]
},
"emissions_lca": {
"co2e_total": 1.42,
"unit": "kg CO₂e"
}
},
"marketing_statements": ["organic", "made in France"],
"certificates": [
{ "name": "EcoCert Organic", "file_url": "https://arkive.com/certificates/EcoCert.pdf", "validated": true }
],
"whitelabel": false
}
Support
For questions, integration guidance, or enterprise onboarding, contact us at service@arkive.nl.