Proof requests
Proof templates are used to create proof requests. When a proof request is created, you will receive a URL which needs to be displayed in a QR code for a wallet application to scan.
Create Proof Request
This route uses a template ID and takes the PEX request you defined there.
Creates a proof request from this template
Proof template UUID
A unique nonce value used in the proof request.
123456
The DID that will be used as the verifier DID in the proof request
did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59
POST /proof-templates/{id}/request HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 81
{
"nonce": "123456",
"did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
}
{
"id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": {
"name": "favouriteDrink",
"names": [
"age"
]
}
},
"name": "Proof request",
"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"
],
"verifierName": "Truvera",
"verifierLogo": "https://logo.truvera.io/verifier"
}
Create Proof Request
This route lets you create a standalone proof request without storing a verification template first.
Create a proof request
Represents a proof request payload in a verifiable credential system.
Proof request name
Proof request
The unique identifier for the template.
37275574-7ea4-438d-b8ef-f8fc61dbf09e
Nonce or challenge for the presentation to match
1234567890
A DID
did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59
POST /proof-requests HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 323
{
"attributes": {
"ANY_ADDITIONAL_PROPERTY": {
"name": "favouriteDrink",
"names": [
"age"
]
}
},
"name": "Proof request",
"template": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
"nonce": "1234567890",
"did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
"request": {
"name": "test request",
"purpose": "my purpose",
"input_descriptors": null
}
}
{
"id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": {
"name": "favouriteDrink",
"names": [
"age"
]
}
},
"name": "Proof request",
"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"
],
"verifierName": "Truvera",
"verifierLogo": "https://logo.truvera.io/verifier"
}
Get all proof requests
How many items to offset by for pagination
0
How many items to return at one time (max 64)
64
GET /proof-requests HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*
[
{
"id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": {
"name": "favouriteDrink",
"names": [
"age"
]
}
},
"name": "Proof request",
"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"
]
}
]
Get the details of an existing proof request
Get the details of an existing proof request
Proof request UUID
GET /proof-requests/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*
{
"id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": {
"name": "favouriteDrink",
"names": [
"age"
]
}
},
"name": "Proof request",
"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"
],
"verifierName": "Truvera",
"verifierLogo": "https://logo.truvera.io/verifier"
}
Delete the proof request
Deletes the proof request and associated data
Proof request UUID
DELETE /proof-requests/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*
No content
Last updated
Was this helpful?