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.