Skip to main content

Introduction to Digital Product Passport APIs

Use Keyban’s Digital Product Passport APIs to issue, enrich, and trace product identities - from factory to resale.

Keyban's Digital Product Passport APIs let you issue, enrich, and monitor tokenized product identities - seamlessly integrated into your existing workflows. Whether you're building for traceability, resale, compliance or marketing, these APIs are designed for flexibility and scale.

Key Benefits​

  • Scalability: Designed to handle large volumes of tokens efficiently.
  • Security: Leverages advanced encryption and robust access controls.
  • Easy Integration: Connect effortlessly with ERP, CRM, and other systems.
  • Efficiency: Streamlines tokenization and blockchain workflows.
  • Progressive Enrichment: Start with basic data at minting and complete the passport later with certifications, events, or ownership transfers.
  • Multi-level structure: Define reusable product-level data, shared lot metadata, and unique item tracking.

Use Cases​

  • Reduce fraud in secondary markets: Verify product authenticity with tokenized IDs.
  • Automate post-sale engagement: Trigger messages or rewards when a product is claimed or resold.
  • Connect supply chain partners: Create trusted, audit-friendly data shared with manufacturers, logistics, and retailers.
  • Prove environmental or safety compliance: Attach verifiable documentation and certifications to products.

Digital Product Passport API Overview​

Our Digital Product Passport APIs let you manage digital product passports from creation to real-time monitoring. For full technical details, please refer to our Tokenization APIs Documentation.

Getting Started​

  1. Create an Application in the Dashboard: Log in to the Keyban Dashboard as an organization admin and create a new application. This will generate an API key that allows you to interact with the REST API to create and manage Digital Product Passports.
  2. Review the Documentation: Follow our integration guides.
  3. Test with Curl:

Here’s an example of how to mint a basic DPP including serial number, category, and descriptive metadata:

curl -L 'https://api.prod.keyban.io/v1/organization/[ORG_ID]/applications/[APP_ID]/tpp/mint' \
-H 'Content-Type: application/jsonl; charset=utf-8' \
-H 'Accept: application/json' \
-H 'X-Api-Key: <X-Api-Key>' \
-d '{"tppId": "b7cd08dc66a04d4c386285715d9026e8cebcbe737e9563f6f1b1aa2c563df98e", "metadata": {"name": "XYZ Mobile 12 5,5 5G 128 Go Double SIM Gris", "description": "Discover the XYZ Mobile 12: a sleek 5G smartphone in grey finish, featuring a 5.5-inch display and 128 GB of storage.", "image": "https://dummyimage.com/600x400/333/fff%26text=Mobile+12+5,5+5G+128+Go", "attributes": [{"trait_type": "Ean", "value": "9783161484100"}, {"trait_type": "Serial number", "value": "SN123"}, {"trait_type": "Product category", "value": "Smartphone 5G"}, {"trait_type": "Brand", "value": "PhoneBrand"}, {"trait_type": "Model", "value": "Z-Phone 12"}, {"trait_type": "Color", "value": "Gris"}], "external_url": "https://www.lipsum.com/feed/html%26amount=20&what=words&start=yes", "creator": "Some integrator ID or Name", "blockchain": "Starknet"}}'

For post-sale engagement or marketing use cases, consider pairing this API with the Keyban DashboardE.