CommonsDB Developer PortalCommonsDB Developer PortalCommonsDB Developer Portal
  • Documentation
  • Declaration API
  • Metadata API
  • Search API
  • Status API
metadata
    Retrieve declaration metadata by identifiergetRetrieve declaration metadata by identifier (Public)get
Schemas
powered by Zudoku
Metadata Engine API

metadata

Endpoint:https://api.commonsdb.org

Metadata retrieval operations for declarations


Retrieve declaration metadata by identifier

GET
https://api.commonsdb.org
/v1/metadata/{identifier}

Retrieve the full declaration metadata using a CIDv1 identifier. The identifier is returned in the response when you submit a declaration (cidV1 field) or in search results.

Retrieve declaration metadata by identifier › path Parameters

  • identifierstring · required

    CIDv1 identifier of the declaration to retrieve

Retrieve declaration metadata by identifier › Headers

  • Authorizationstring · required

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

Retrieve declaration metadata by identifier › Responses

Successful operation - Declaration metadata retrieved

  • signaturestring

    JWT signature of the declaration metadata

  • tsaSignatureobject

    Timestamp Authority signature

  • commonsDbRegistrySignaturestring

    JWT signature of commonsDbRegistry (if present)

  • commonsDbRegistryTsaSignatureobject

    Timestamp Authority signature

  • declarationMetadataobject
  • metaInternalobject

    Internal metadata for tracking and identification

GET /v1/metadata/{identifier}

Retrieve declaration metadata by identifier (Public)

GET
https://api.commonsdb.org
/v1/metadata-pub/{identifier}

Public endpoint to retrieve declaration metadata. Does not require API key authentication but may have stricter rate limits.

Retrieve declaration metadata by identifier (Public) › path Parameters

  • identifierstring · required

    CIDv1 identifier of the declaration to retrieve

Retrieve declaration metadata by identifier (Public) › Responses

Successful operation - Declaration metadata retrieved

  • signaturestring

    JWT signature of the declaration metadata

  • tsaSignatureobject

    Timestamp Authority signature

  • commonsDbRegistrySignaturestring

    JWT signature of commonsDbRegistry (if present)

  • commonsDbRegistryTsaSignatureobject

    Timestamp Authority signature

  • declarationMetadataobject
  • metaInternalobject

    Internal metadata for tracking and identification

GET /v1/metadata-pub/{identifier}