Trust Registry Schemas | Truvera Documentation portal

Get Trust Registry schemas

get

Returns the Trust Registry schemas

Authorizations

Path parameters

registryIdstringRequired

A trust registry id

Query parameters

offsetinteger · int32Optional

How many items to offset by for pagination

Default: 0

limitinteger · int32 · min: 1 · max: 64Optional

How many items to return at one time (max 64)

Default: 64

participantsinteger · int32 · min: 1 · max: 64Optional

How many participants to return per schema

Default: 5

Responses

200

List of schemas in the trust registry

application/json

400

Application error

application/json

401

Unauthorized.

application/json

404

Trust Registry was not found.

application/json

get

GET /trust-registries/{registryId}/schemas HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

{
  "total": 200,
  "list": [
    {
      "id": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
      "name": "Example Schema",
      "public": true,
      "participantCount": 10,
      "prices": [
        {
          "currency": "USD",
          "digits": 100000000,
          "verifier": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
        }
      ],
      "topParticipants": [
        {
          "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
          "name": "Truvera Issuer",
          "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
          "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
          "logoUrl": "https://logo.truvera.io/participant",
          "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
          "status": "active",
          "role": "issuer",
          "created": "2025-08-20T18:51:58.567Z",
          "suspendedAt": "text",
          "issuerSchemas": [
            "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
          ],
          "verifierSchemas": [
            "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
          ]
        }
      ]
    }
  ]
}

parameters

Authorizations

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

parameters

PARAMETERS /trust-registries/{registryId}/schemas/{schemaId}/price HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

Creates or updates a price for a schema ID with given currency and digits on a per issuer basis

post

Authorizations

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

Body

currencystringRequired

Currency code

Example: USD

digitsone ofRequired

Bigint representation of the price. Multiply by 1,000,000 to support fractional cents.

Example: 100000000

integerOptional

or

stringOptional

verifierstring · min: 32Optional

DID as fully qualified, typically. did:cheqd:

Example: did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59

Responses

200

Trust Registry schema price has been updated

400

Error updating or adding price

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

404

Trust Registry was not found.

application/json

post

POST /trust-registries/{registryId}/schemas/{schemaId}/price HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "currency": "USD",
  "digits": 100000000,
  "verifier": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
}

No content

List prices for schema IDs

get

Get all prices for schema IDs

Authorizations

Query parameters

idsstringRequired

Comma separated list of schema IDs

Responses

200

All schema prices

application/json

get

GET /trust-registries/schema-prices HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

200

All schema prices

[
  {
    "schema": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
    "prices": [
      {
        "currency": "USD",
        "digits": 100000000,
        "trustRegistryId": "0x601d148fb8895aca83eafb264293069911f76805b748b014ae64fcf0fd2d765d",
        "trustRegistryMetadata": {
          "name": "Example Trust Registry",
          "logoUrl": "https://logo.truvera.io/trust-registry",
          "description": "Example Trust Registry Description",
          "ecosystemUrl": "https://ecosystem.truvera.io",
          "governanceFramework": "Example Governance Framework",
          "governanceFrameworkVersion": 1
        }
      }
    ]
  }
]

List all the DIDs belonging to the user that are linked to the requested schemas.

get

Get all dids owned by user for schema IDs

Authorizations

Query parameters

idsstringRequired

Comma separated list of schema IDs

Responses

200

All schema dids owned by user

application/json

get

GET /trust-registries/schema-dids HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

200

All schema dids owned by user

[
  {
    "schema": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
    "dids": [
      "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
    ]
  }
]

Remove Trust Registry schema

delete

Unassigns a schema from all participants in the trust registry

Authorizations

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

Responses

200

Trust Registry schema has been deleted

400

Something went wrong with deleting the schema

application/json

401

Unauthorized.

application/json

404

Trust Registry does not exist

application/json

delete

DELETE /trust-registries/{registryId}/schemas/{schemaId} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

No content