Credential schemas

Schemas are useful when enforcing a specific structure on a collection of data like a Verifiable Credential. Data Verification schemas, for example, are used to verify that the structure and contents of a Verifiable Credential conform to a published schema. On the other hand, Data Encoding schemas are used to map the contents of a Verifiable Credential to an alternative representation format, such as a binary format used in a zero-knowledge proof.

Truvera credential schemas are using json schema format and should follow this structure https://json-schema.org/understanding-json-schema/reference

Create schema

Schemas are used to describe the structure of credentials, specifically the credential subject. It helps the issuer, holder, and verifier to unambiguously determine the claims contained within the credential. To create a schema, you need to define the object body using JSON schema.

Parameters

Name	In	Type	Required	Description
body	body	object	true	JSON-schema.

Create Credential Schema

post

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

/schemas

Creates a JSON schema on the blockchain. More info about Schema Creation

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Verifiable Credential Schema

$schemastringOptional

The schema version, generally following the JSON-schema specification.

Example: http://json-schema.org/draft-07/schema#

namestringOptional

Name of the schema.

Example: My Schema

descriptionstringOptional

A brief description of the schema.

Example: Truvera Schema Example

typestringOptional

Defines the type of schema. Usually 'object'.

Example: object

propertiesobjectOptional

The properties that define the schema.

Example: {"id":{"type":"string"},"emailAddress":{"type":"string","format":"email"},"alumniOf":{"type":"string"}}

requiredstring[]Optional

Required fields within the schema.

Example: ["emailAddress","alumniOf"]

additionalPropertiesbooleanOptional

Specifies whether additional properties outside the defined schema are allowed.

Example: true

Responses

200

Schema will be created.

application/json

Object containing unique id of the background task and associated data. This id can be used to query the job status

idstringOptional

dataobjectOptional

400

Invalid params like size not supported or not JSON.

application/json

401

Unauthorized

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

post

/schemas

HTTPcURLJavaScriptPython

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

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "name": "My Schema",
  "description": "Truvera Schema Example",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "emailAddress": {
      "type": "string",
      "format": "email"
    },
    "alumniOf": {
      "type": "string"
    }
  },
  "required": [
    "emailAddress",
    "alumniOf"
  ],
  "additionalProperties": true
}

{
  "id": "2549",
  "data": {
    "id": "1a678fe6973f34d2a5c016cbff347161b9a595f5cc44a3e15f1eca2a404f294a",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Truvera Schema Example",
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "emailAddress": {
          "type": "string",
          "format": "email"
        },
        "alumniOf": {
          "type": "string"
        }
      },
      "required": [
        "emailAddress",
        "alumniOf"
      ],
      "additionalProperties": false
    }
  }
}

List schemas

Return a list of all schemas created by the authenticated user.

Parameters

Name	In	Type	Required	Description
offset	query	integer	false	How many items to offset by for pagination
limit	query	integer	false	How many items to return at one time (max 64)

List Schemas

get

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

/schemas

Get all schemas created by user. More info about List Schemas

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

includeEcosystemsbooleanOptional

Whether to include ecosystems or not

Default: true

Responses

200

All schemas by user

application/json

idstringOptional

The schema ID

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

schemaany ofOptional

undefined · enumOptional

for adding nullability to a ref

Possible values:

or

uristringOptional

The schema URI

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

createdstring · date-timeOptional

isOwnerbooleanOptional

Whether the current user is the owner of the schema

Example: true

ownerNamestringOptional

The owner name

Example: Truvera

ownerLogostringOptional

The owner logo

Example: https://logo.truvera.io/owner

400

Application error

application/json

get

/schemas

HTTPcURLJavaScriptPython

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

[
  {
    "id": "db0c559035226419b4061d7c725a6d7d8aeebd3acf784fd0d69c9a033f29a8d1",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Truvera Schema Example",
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "emailAddress": {
          "type": "string",
          "format": "email"
        },
        "alumniOf": {
          "type": "string"
        },
        "birthDate": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "emailAddress",
        "alumniOf"
      ],
      "additionalProperties": false
    },
    "author": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "uri": "https://schema.truvera.io/myschema.json"
  },
  {
    "id": "f408d91da3ebab27f2d50150f7cf54ab14099b3ab5f53e2cbf208a90d6adbfd7",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Truvera Schema Example",
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "emailAddress": {
          "type": "string",
          "format": "email"
        },
        "alumniOf": {
          "type": "string"
        },
        "birthDate": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "emailAddress",
        "alumniOf"
      ],
      "additionalProperties": false
    },
    "author": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "uri": "https://schema.truvera.io/myschema.json"
  },
  {
    "id": "37ad6cf1c51a33ba25f50a8f106e2b06f9e1963296c5bfd914c0d71b7bad42e6",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Truvera Schema Example",
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "emailAddress": {
          "type": "string",
          "format": "email"
        },
        "alumniOf": {
          "type": "string"
        },
        "birthDate": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "emailAddress",
        "alumniOf"
      ],
      "additionalProperties": false
    },
    "author": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "uri": "https://schema.truvera.io/myschema.json"
  }
]

Get schema

Reading a Schema from the blockchain can easily be achieved by using the get method which will return the JSON schema to a specific schema ID. The schemaIdneeds to be URL encoded (e.g. /schemas/https%3A%2F%2Fschema.dock.io%2FTestSchema-V1-1695817897561.json)

Parameters

Name	In	Type	Required	Description
schemaId	path	String	true	A URL encoded schema id.

Get Schema

get

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

/schemas/{schemaId}

Returns the JSON schema for a specific ID. More info about Get Schema By ID

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

schemaIdstring · min: 64 · max: 64Required

32 byte hex string. Ignoring higher base (base64) for simplicity.

Responses

200

Schema

application/json

idstringOptional

The schema ID

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

schemaany ofOptional

undefined · enumOptional

for adding nullability to a ref

Possible values:

or

uristringOptional

The schema URI

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

createdstring · date-timeOptional

isOwnerbooleanOptional

Whether the current user is the owner of the schema

Example: true

ownerNamestringOptional

The owner name

Example: Truvera

ownerLogostringOptional

The owner logo

Example: https://logo.truvera.io/owner

400

Application error

application/json

404

Schema was not found.

application/json

get

/schemas/{schemaId}

HTTPcURLJavaScriptPython

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

{
  "id": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
  "schema": null,
  "uri": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
  "created": "2026-03-20T16:52:06.710Z",
  "isOwner": true,
  "ownerName": "Truvera",
  "ownerLogo": "https://logo.truvera.io/owner"
}

Delete schema

Delete Schema

delete

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

/schemas/{schemaId}

Deletes a schema from the database

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

schemaIdstring · min: 64 · max: 64Required

32 byte hex string. Ignoring higher base (base64) for simplicity.

Responses

200

Schema has been deleted

application/json

Object containing unique id of the background task and associated data. This id can be used to query the job status

idstringOptional

dataobjectOptional

400

Something went wrong with deleting the schema

application/json

401

Unauthorized.

application/json

404

Schema does not exist

application/json

500

Something went wrong with deleting the schema

application/json

delete

/schemas/{schemaId}

HTTPcURLJavaScriptPython

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

{
  "id": "2434",
  "data": {
    "status": "pending"
  }
}