Creating a trust registry

Create Trust Registry

post

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

/trust-registries

Creates a new trust registry. You must be on a Custom plan to do this.

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

convenerstring · min: 32Required

DID as fully qualified, typically. did:cheqd:

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

namestringRequired

Trust registry name

Example: Truvera Example Ecosystem

descriptionstringRequired

Trust registry description

Example: Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.

logoUrlstring · uri · min: 8RequiredExample: https://logo.truvera.io/trust-registry

ecosystemUrlstring · uri · min: 8RequiredExample: https://ecosystem.truvera.io

governanceFrameworkstringRequired

Trust registry governance framework

Example: Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.

governanceFrameworkVersionstringRequired

Trust registry governance framework version

Example: 1.0.0

Responses

200

Trust registry has been created

application/json

400

Invalid parameters or error occurred

application/json

401

Unauthorized

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

post

/trust-registries

HTTPcURLJavaScriptPython

POST /trust-registries HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 425

{
  "convener": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "name": "Truvera Example Ecosystem",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/trust-registry",
  "ecosystemUrl": "https://ecosystem.truvera.io",
  "governanceFramework": "Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.",
  "governanceFrameworkVersion": "1.0.0"
}

{
  "id": "0x601d148fb8895aca83eafb264293069911f76805b748b014ae64fcf0fd2d765d",
  "convener": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "convenerName": "Truvera",
  "convenerLogoUrl": "https://logo.truvera.io/convener",
  "slug": "truvera-example-ecosystem-1",
  "nonce": "0x57aecb3863404812",
  "created": "2026-01-09T07:57:18.543Z",
  "name": "Truvera Example Ecosystem",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/trust-registry",
  "ecosystemUrl": "https://ecosystem.truvera.io",
  "governanceFramework": "Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.",
  "governanceFrameworkVersion": "1.0.0",
  "issuerCount": 10,
  "verifierCount": 5
}

List Trust Registries

get

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

/trust-registries

Get all trust registries owned by the user

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

Responses

200

All trust registries

application/json

get

/trust-registries

HTTPcURLJavaScriptPython

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

200

All trust registries

[
  {
    "id": "0x601d148fb8895aca83eafb264293069911f76805b748b014ae64fcf0fd2d765d",
    "convener": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "convenerName": "Truvera",
    "convenerLogoUrl": "https://logo.truvera.io/convener",
    "slug": "truvera-example-ecosystem-1",
    "nonce": "0x57aecb3863404812",
    "created": "2026-01-09T07:57:18.543Z",
    "name": "Truvera Example Ecosystem",
    "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
    "logoUrl": "https://logo.truvera.io/trust-registry",
    "ecosystemUrl": "https://ecosystem.truvera.io",
    "governanceFramework": "Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.",
    "governanceFrameworkVersion": "1.0.0",
    "issuerCount": 10,
    "verifierCount": 5
  }
]

Query all trust registries

post

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

/trust-registries/query

Query all trust registries

Body

application/json

verifierDIDstring · min: 32Optional

DID as fully qualified, typically. did:cheqd:

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

issuerDIDstring · min: 32Optional

DID as fully qualified, typically. did:cheqd:

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

schemastringOptional

Responses

200

Trust registries

application/json

400

Invalid parameters or error occurred

application/json

post

/trust-registries/query

HTTPcURLJavaScriptPython

POST /trust-registries/query HTTP/1.1
Host: api-testnet.truvera.io
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "verifierDID": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "issuerDID": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "schema": "text"
}

[
  {
    "id": "0x601d148fb8895aca83eafb264293069911f76805b748b014ae64fcf0fd2d765d",
    "convener": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "convenerName": "Truvera",
    "convenerLogoUrl": "https://logo.truvera.io/convener",
    "slug": "truvera-example-ecosystem-1",
    "nonce": "0x57aecb3863404812",
    "created": "2026-01-09T07:57:18.543Z",
    "name": "Truvera Example Ecosystem",
    "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
    "logoUrl": "https://logo.truvera.io/trust-registry",
    "ecosystemUrl": "https://ecosystem.truvera.io",
    "governanceFramework": "Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.",
    "governanceFrameworkVersion": "1.0.0",
    "issuerCount": 10,
    "verifierCount": 5
  }
]

parameters

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

/trust-registries/{registryId}

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

registryIdstringRequired

A trust registry id

parameters

/trust-registries/{registryId}

HTTPcURLJavaScriptPython

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

Get Trust Registry

get

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

/trust-registries/{registryId}

Returns the Trust Registry for a specific ID.

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

registryIdstringRequired

A trust registry id

Responses

200

Trust Registry information

application/json

400

Application error

application/json

401

Unauthorized.

application/json

404

Trust Registry was not found.

application/json

get

/trust-registries/{registryId}

HTTPcURLJavaScriptPython

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

{
  "id": "0x601d148fb8895aca83eafb264293069911f76805b748b014ae64fcf0fd2d765d",
  "convener": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "convenerName": "Truvera",
  "convenerLogoUrl": "https://logo.truvera.io/convener",
  "slug": "truvera-example-ecosystem-1",
  "nonce": "0x57aecb3863404812",
  "created": "2026-01-09T07:57:18.543Z",
  "name": "Truvera Example Ecosystem",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/trust-registry",
  "ecosystemUrl": "https://ecosystem.truvera.io",
  "governanceFramework": "Lorem ea ea reprehenderit cupidatat minim incididunt occaecat est sit.",
  "governanceFrameworkVersion": "1.0.0",
  "issuerCount": 10,
  "verifierCount": 5
}