Getting Started

Welcome to the Liccium API and Developer Platform

Liccium is providing an open trust infrastructure for verifiable declarations of rights and metadata for digital content. This platform is designed for developers, media organisations, and rights professionals looking to integrate trusted declarations into their digital workflows.

Liccium enables creators, rightsholders, platforms, AI providers, and media organisations to declare authorship, rights, provenance, AI involvement, and AI usage preferences for both original and synthetic content.

Through cryptographically verifiable records published on federated registries, the platform ensures transparency, supports FAIR and machine-readable metadata, and guarantees provable integrity and global discoverability.

APIs Overview

Liccium offers a modular suite of APIs and registry services.

Declaration API

Submit metadata declarations for digital content using ISCC codes, with optional plugin modules (e.g. TDM-AI, IPTC, Creative Commons). Declarations are digitally signed, timestamped, and optionally pushed to one or more federated registries.

Metadata API

Fetch FAIR and signed provenance metadata for each declaration (CID). Includes fields such as declarer ID, plugin payloads, timestamps, and registry signatures.

Search API

Search declarations by ISCC, metadata, creator ID (did), declared keywords, or provenance flags. Designed to support similarity-based discovery and originality verification.

What You'll Find Here

This documentation provides a full technical guide for integrating Liccium's APIs into your software or services. It includes:

  • JSON examples for every endpoint
  • Specification of supported metadata schemas
  • Plugin integration and validation formats
  • Federated registry structures and publishing logic
  • Reference implementations

New to Liccium? Start Here

If you're just getting started, we recommend reading the General Information section to understand the key concepts and processes:

  • What is an ISCC and how to generate it
  • What kind of metadata a declaration contains
  • How plugin metadata (e.g. TDMAI, IPTC, C2PA) is embedded in the declaration
  • How federated registries work (TDMAI, FAIA)

Next Steps

  1. Understand the Basics

    Start with our General Information section to learn how to generate ISCC fingerprints, structure metadata declarations, and use the cryptographic methods that ensure the integrity and trustworthiness of Liccium records.

  2. Set Up Authentication

    To submit a declaration via the Liccium API, you need an API key.

    In addition, all declarations must be authenticated using a valid digital certificate or verifiable credential.

    Liccium accepts only certified declarations to ensure trust and accountability.

    Depending on your role, authentication must be established using one of the following methods:

    • For legal entities: a qualified electronic seal (eSeal) certificate
    • For individual users: a verifiable credential (VC) linked to a key pair, issued by Liccium or any other recognised trust service

    These credentials are required to authenticate your signature and ensure that your declarations can be verified. They are essential to making Liccium declarations cryptographically secure and legally reliable.

  3. Explore the APIs

    Check out the API specifications:

  4. Implement Your Solution

    Use our code snippets and the Docker tools to:

    • Generate ISCC codes
    • Submit declarations
    • Retrieve metadata
    • Explore registry records

Support and Contribution

Liccium is founded on principles of transparency, interoperability, and open standards.

For support or further information, contact us at [email protected] or explore our documentation at docs.liccium.com.

Last modified on