Trust registry schemas

Get Trust Registry schemas

get

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/{registryId}/schemas

Returns the Trust Registry schemas

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/trust-registries/{registryId}/schemas

HTTPcURLJavaScriptPython

GET /trust-registries/{registryId}/schemas HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
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": "2026-01-22T01:27:04.456Z",
          "suspendedAt": "text",
          "issuerSchemas": [
            "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
          ],
          "verifierSchemas": [
            "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
          ]
        }
      ]
    }
  ]
}

parameters

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/{registryId}/schemas/{schemaId}/price

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

parameters

/trust-registries/{registryId}/schemas/{schemaId}/price

HTTPcURLJavaScriptPython

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

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

post

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/{registryId}/schemas/{schemaId}/price

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

Body

application/json

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

No content

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

/trust-registries/{registryId}/schemas/{schemaId}/price

HTTPcURLJavaScriptPython

POST /trust-registries/{registryId}/schemas/{schemaId}/price HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
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

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/schema-prices

Get all prices for schema IDs

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

idsstringRequired

Comma separated list of schema IDs

Responses

200

All schema prices

application/json

get

/trust-registries/schema-prices

HTTPcURLJavaScriptPython

GET /trust-registries/schema-prices?ids=text HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
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

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/schema-dids

Get all dids owned by user for schema IDs

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

idsstringRequired

Comma separated list of schema IDs

Responses

200

All schema dids owned by user

application/json

get

/trust-registries/schema-dids

HTTPcURLJavaScriptPython

GET /trust-registries/schema-dids?ids=text HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
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

https://api-testnet.truvera.iohttps://api.truvera.io

/trust-registries/{registryId}/schemas/{schemaId}

Unassigns a schema from all participants in the trust registry

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

registryIdstringRequired

A trust registry id

schemaIdstringRequired

A schema id

Responses

200

Trust Registry schema has been deleted

No content

400

Something went wrong with deleting the schema

application/json

401

Unauthorized.

application/json

404

Trust Registry does not exist

application/json

delete

/trust-registries/{registryId}/schemas/{schemaId}

HTTPcURLJavaScriptPython

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

No content