Liccium Developer Portal
Declaration Engine API

declare

Endpoint:https://b2c-api-main-737c477.zuplo.app

Submit a new Declaration to registries

POST
https://b2c-api-main-737c477.zuplo.app
/v1/declare

Submit a new Declaration to the Liccium registry. The declaration must include:

  • JWT signature (ES256) with JWK or x5c in the header
  • TSA signature with timestamp request (TSQ) and response (TSR)
  • Valid ISCC code in format ISCC:XXXXXXX (55 character alphanumeric code)
  • declarerId as DID
  • Timestamp within the allowed server window

Submit a new Declaration to registries › Headers

  • Authorizationstring · required

    Bearer token for authentication (e.g., Bearer <your-api-key>)

Submit a new Declaration to registries › Request Body

  • signaturestring · pattern: ^[A-Za-z0-9_-]+\.[A-… · required

    JWT signature of declaration metadata

  • tsaSignatureobject · required

    Timestamp Authority signature containing timestamp request and response payloads

  • declarationMetadataobject · required
  • tdmaiRegistrySignaturestring · pattern: ^[A-Za-z0-9_-]+\.[A-…

    JWT signature of the tdmaiRegistry payload. Required when tdmaiRegistry is provided.

  • tdmaiRegistryTsaSignatureobject

    TSA signature of the tdmaiRegistry payload. Required when tdmaiRegistry is provided.

Submit a new Declaration to registries › Responses

Declaration accepted successfully

  • rayIdstring

    Unique identifier for the request

  • messagestring

    Status message of the ingestion

  • envstring

    Environment where the declaration was ingested

  • isccstring

    ISCC code of the ingested declaration

  • cidV1string

    Content Identifier Version 1 of the ingested declaration

  • versionstring

    API version