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

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

Authorizations

bearerAuthaccessTokennextAuth

Body

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

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

HTTPcURLJavaScriptPython

POST /schemas HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
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

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

Authorizations

bearerAuthaccessTokennextAuth

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

400

Application error

application/json

get

HTTPcURLJavaScriptPython

GET /schemas HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
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

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

Authorizations

bearerAuthaccessTokennextAuth

Path parameters

schemaIdstring · min: 64 · max: 64Required

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

Responses

200

Schema

application/json

400

Application error

application/json

404

Schema was not found.

application/json

get

HTTPcURLJavaScriptPython

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

{
  "id": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
  "schema": null,
  "uri": "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json",
  "created": "2025-06-02T01:30:16.480Z",
  "isOwner": true,
  "ownerName": "Truvera",
  "ownerLogo": "https://logo.truvera.io/owner"
}

Delete Schema

Delete Schema

delete

Deletes a schema from the database

Authorizations

bearerAuthaccessTokennextAuth

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

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

HTTPcURLJavaScriptPython

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

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