Proof templates

It is common to repeatedly request the same information from holders in subsequent proof requests. The Truvera API makes this easy by allowing you to create proof request templates to define the contents of the proof requests in a way that can be reused. The Truvera Workspace refers to proof request templates as "verification templates".

To verify a credential with Truvera, the verifier will need to create a proof template and generate a proof request to which the holder wallet will provide the verifiable presentation. Verifiable presentations can not be created via the REST API, as the Truvera Wallet SDK should be used.

Create a proof template

Create a new proof template

post

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

/proof-templates

Create a proof template

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Represents a proof template payload in a verifiable credential system.

namestringRequired

Proof request name

Example: Proof request

cedarVerificationPolicystringOptional

Optional Cedar policy to run on verification

didstring · min: 32Optional

A DID

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

Responses

200

Proof request template created

application/json

idstring · uuidRequired

The unique identifier for the proof template.

totalRequestsintegerOptional

The total number of proof requests associated with the template.

Example: 1

isOwnerbooleanOptional

Whether the current user is the owner of the template

Example: true

createdstring · date-timeRequired

updatedstring · date-timeRequired

didstring · min: 32Optional

A DID

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

typesstring[]Optional

An array of types indicating the formats or methods that can be used for the proof.

Example: jsonld

400

Invalid parameters

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

post

/proof-templates

HTTPcURLJavaScriptPython

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

{
  "name": "Proof request",
  "cedarVerificationPolicy": "text",
  "request": {
    "name": "test request",
    "purpose": "my purpose",
    "input_descriptors": null
  },
  "expirationTime": {
    "amount": 1,
    "unit": "months"
  },
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "totalRequests": 1,
  "isOwner": true,
  "created": "2026-02-22T15:11:38.155Z",
  "updated": "2026-02-22T15:11:38.155Z",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "request": {
    "name": "test request",
    "purpose": "my purpose",
    "input_descriptors": null
  },
  "types": [
    "jsonld"
  ]
}

Get proof templates

List all proof templates

get

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

/proof-templates

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

A paged array of proof templates

application/json

idstring · uuidRequired

The unique identifier for the proof template.

totalRequestsintegerOptional

The total number of proof requests associated with the template.

Example: 1

isOwnerbooleanOptional

Whether the current user is the owner of the template

Example: true

createdstring · date-timeRequired

updatedstring · date-timeRequired

didstring · min: 32Optional

A DID

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

typesstring[]Optional

An array of types indicating the formats or methods that can be used for the proof.

Example: jsonld

400

Application error

application/json

get

/proof-templates

HTTPcURLJavaScriptPython

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

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "totalRequests": 1,
    "isOwner": true,
    "created": "2026-02-22T15:11:38.155Z",
    "updated": "2026-02-22T15:11:38.155Z",
    "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "request": {
      "name": "test request",
      "purpose": "my purpose",
      "input_descriptors": null
    },
    "types": [
      "jsonld"
    ]
  }
]

Get details of a specific proof template

Get proof templates

get

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

/proof-templates/{id}

Get the details of an existing proof templates

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Responses

200

Returns the information about the proof templates

application/json

idstring · uuidRequired

The unique identifier for the proof template.

totalRequestsintegerOptional

The total number of proof requests associated with the template.

Example: 1

isOwnerbooleanOptional

Whether the current user is the owner of the template

Example: true

createdstring · date-timeRequired

updatedstring · date-timeRequired

didstring · min: 32Optional

A DID

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

typesstring[]Optional

An array of types indicating the formats or methods that can be used for the proof.

Example: jsonld

400

Application error

application/json

404

Proof templates was not found.

application/json

get

/proof-templates/{id}

HTTPcURLJavaScriptPython

GET /proof-templates/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "totalRequests": 1,
  "isOwner": true,
  "created": "2026-02-22T15:11:38.155Z",
  "updated": "2026-02-22T15:11:38.155Z",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "request": {
    "name": "test request",
    "purpose": "my purpose",
    "input_descriptors": null
  },
  "types": [
    "jsonld"
  ]
}

Update a proof template

Update a proof template

patch

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

/proof-templates/{id}

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Body

application/json

Represents a proof template payload in a verifiable credential system.

namestringRequired

Proof request name

Example: Proof request

cedarVerificationPolicystringOptional

Optional Cedar policy to run on verification

didstring · min: 32Optional

A DID

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

Responses

200

Profile has been updated

application/json

idstring · uuidRequired

The unique identifier for the proof template.

totalRequestsintegerOptional

The total number of proof requests associated with the template.

Example: 1

isOwnerbooleanOptional

Whether the current user is the owner of the template

Example: true

createdstring · date-timeRequired

updatedstring · date-timeRequired

didstring · min: 32Optional

A DID

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

typesstring[]Optional

An array of types indicating the formats or methods that can be used for the proof.

Example: jsonld

400

Error creating profile

application/json

401

Unauthorized

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

404

Proof templates was not found.

application/json

patch

/proof-templates/{id}

HTTPcURLJavaScriptPython

PATCH /proof-templates/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 248

{
  "name": "Proof request",
  "cedarVerificationPolicy": "text",
  "request": {
    "name": "test request",
    "purpose": "my purpose",
    "input_descriptors": null
  },
  "expirationTime": {
    "amount": 1,
    "unit": "months"
  },
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "totalRequests": 1,
  "isOwner": true,
  "created": "2026-02-22T15:11:38.155Z",
  "updated": "2026-02-22T15:11:38.155Z",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "request": {
    "name": "test request",
    "purpose": "my purpose",
    "input_descriptors": null
  },
  "types": [
    "jsonld"
  ]
}

Get proof requests from template

Use the Verified parameter when needing to get only those verifications that were succsessful.

Gets the proof requests from this template

get

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

/proof-templates/{id}/history

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Query parameters

verifiedbooleanOptional

Whether the presentation was verified or not

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

Returns the information about the proof request history

application/json

400

Application error

application/json

404

Proof template was not found.

application/json

get

/proof-templates/{id}/history

HTTPcURLJavaScriptPython

GET /proof-templates/{id}/history HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
    "attributes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "name": "favouriteDrink",
        "names": [
          "age"
        ]
      }
    },
    "name": "Proof request",
    "cedarVerificationPolicy": "text",
    "nonce": "1234567890",
    "error": "text",
    "response_url": "http://api-testnet.truvera.io/proof-requests/37275574-7ea4-438d-b8ef-f8fc61dbf09e/send-presentation",
    "qr": "http://creds-testnet.truvera.io/proof/37275574-7ea4-438d-b8ef-f8fc61dbf09e",
    "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
    "verified": false,
    "expired": false,
    "presentation": {},
    "created": "2024-09-26T12:38:10.871Z",
    "updated": "2024-09-26T12:38:10.871Z",
    "request": {
      "name": "test request",
      "purpose": "my purpose",
      "input_descriptors": null
    },
    "type": "proof-request",
    "types": [
      "jsonld"
    ],
    "credentialsIssuers": [
      {
        "issuerDid": "text",
        "issuerName": "text",
        "issuerLogo": "text",
        "issuerTrustRegistries": [
          {
            "name": "text",
            "logoUrl": "text"
          }
        ]
      }
    ]
  }
]

Delete a proof template

Delete proof templates

delete

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

/proof-templates/{id}

Deletes the proof templates and associated data

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Responses

200

Proof templates will be deleted

No content

400

Something went wrong.

application/json

401

Unauthorized

application/json

404

Proof templates was not found.

application/json

delete

/proof-templates/{id}

HTTPcURLJavaScriptPython

DELETE /proof-templates/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete history for a proof template

This endpoint provides an irreversible deletion of all of proof template's verification history data.

Deletes all the history for this proof template

delete

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

/proof-templates/{id}/history

Deletes all the history for this proof template

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Query parameters

verifiedbooleanOptional

Whether the presentation was verified or not

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

Proof requests have been deleted

No content

400

Something went wrong.

application/json

404

Proof template was not found.

application/json

delete

/proof-templates/{id}/history

HTTPcURLJavaScriptPython

DELETE /proof-templates/{id}/history HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete a proof template

Delete proof templates

delete

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

/proof-templates/{id}

Deletes the proof templates and associated data

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Proof template UUID

Responses

200

Proof templates will be deleted

No content

400

Something went wrong.

application/json

401

Unauthorized

application/json

404

Proof templates was not found.

application/json

delete

/proof-templates/{id}

HTTPcURLJavaScriptPython

DELETE /proof-templates/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content