Truvera Documentation portal
WebsiteTruvera Workspace
  • Truvera overview
    • Decentralized identity explained
    • Roadmap
    • Subscription plans & billing
  • Solutions
    • Biometric-Bound Credentials
  • Truvera Workspace
    • Create an organization profile (DID)
    • Issue verifiable credentials
      • Filtering, downloading and deleting credentials
    • Verify credentials
    • Create a schema
    • Create a design
    • Team management
      • Inviting a team member
      • Removing a team member
      • Changing team member roles
      • Data retention policies
      • Sub-accounts
    • Revoking credentials
    • Ecosystem Tools
      • Ecosystem set up
      • Ecosystem example
    • Monetizing credentials
      • Setting up monetizable credentials
    • Creating API keys and webhook endpoints
    • Transaction history
    • Custom branded distribution emails
    • Truvera Workspace release notes
      • 2025 Release notes
        • Release notes Q1 2025
      • 2024 Release notes
        • Release Notes February 2024
        • Release Notes March 2024
        • Release Notes April 2024
        • Release Notes May 2024
        • Release Notes June 2024
        • Release Notes July 2024
        • Release Notes August 2024
        • Release Notes September 2024
        • Release Notes October 2024
        • Release notes November 2024
        • Release notes December 2024
  • Truvera API
    • Getting started
    • Webhooks
      • Webhooks API endpoints
    • Sample Postman collections
      • Issue-Store-Verify sample flow
      • Create ecosystems
      • Issue monetizable credentials
      • Create sub-accounts
      • Issue OpenID credentials
    • Truvera Swagger UI
    • DIDs
    • Profiles
    • Credentials
    • Presentations
      • Proof templates
      • Proof requests
      • Other proof endpoints
    • Registries
    • Revocation Status
    • Credential Schemas
    • Jobs
    • Templates
    • Sub-accounts
    • Teams
    • Messaging
    • OpenID
      • OpenID Issuance and Verification Integration Guide
    • iden3comm
    • Ecosystem Tools
      • Trust Registry Integration Guide
      • Creating a Trust Registry
      • Inviting participants
      • Verifiers and Public info
      • Trust Registry Schemas
      • Trust Registry Proof Templates
      • Reports
      • Updating and Deleting Trust Registry
    • Issuing paid credentials (KVAC algorithm integration)
    • Data
    • Verify
    • Keys
    • Schemas
  • System architecture
    • Proposed architecture with Truvera
    • Revocation
    • System scalability
    • Security policies
    • How data is processed and stored
  • Supported standards
    • Interoperability with OpenID
  • Credential wallet
    • Create and manage DIDs in the Truvera Wallet
    • White label wallet
      • Configuration
        • Enabling and Disabling Features
        • Customizing the Styling
        • Configuring for Android Builds
        • Configuring iOS Builds
      • Publishing in App Stores
        • Android Build Testing and Publishing
        • iOS Build Testing and Publishing
    • Wallet SDK
      • Getting started
        • Example Credential
        • Presentation definition
        • Verify credentials
      • Cloud wallet
      • Biometric plugin
      • Ecosystem Tools
    • Download Truvera Wallet
    • Truvera Wallet release notes
      • Release Notes 2025Q1
      • Release Notes 2024Q4
      • Release Notes 2024Q3
        • Release Notes September 2024
        • Release Notes August 2024
        • Release Notes July 2024
      • Release Notes June 2024
      • Release Notes May 2024
      • Release Notes April 2024
  • Open source community
    • Code of Conduct
    • Truvera Credential SDK
    • Blockchain archives
      • DOCK token
        • Migration terms and conditions
  • Support
    • System Status
    • Discord
    • Support services
    • Security policy
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Truvera API
  2. Ecosystem Tools

Trust Registry Schemas

PreviousVerifiers and Public infoNextTrust Registry Proof Templates

Last updated 5 months ago

Was this helpful?

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-06-02T04:33:54.296Z",
          "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: */*

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

  • GETGet Trust Registry schemas
  • PARAMETERS/trust-registries/{registryId}/schemas/{schemaId}/price
  • POSTCreates or updates a price for a schema ID with given currency and digits on a per issuer basis
  • GETList prices for schema IDs
  • GETList all the DIDs belonging to the user that are linked to the requested schemas.
  • DELETERemove Trust Registry schema

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