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. Presentations

Other proof endpoints

PreviousProof requestsNextRegistries

Last updated 5 months ago

Was this helpful?

Send a presentation to the proof request

Get the proof request PEX definition

Get the proof request PEX definition

get

Get the proof request PEX definition

Path parameters
idstring · uuidRequired

OpenID issuer UUID

Responses
200
The proof request PEX definition
application/json
Responseobject
400
Application error
application/json
404
Not Found
application/json
get
GET /proof-requests/{id}/pex HTTP/1.1
Host: api-testnet.truvera.io
Accept: */*
{}
  • Send a presentation to the proof request
  • POSTSends presentation to proof request
  • Get the proof request PEX definition
  • GETGet the proof request PEX definition

Sends presentation to proof request

post

Sends a presentation to the request

Path parameters
idstring · uuidRequired

Proof request UUID

Body
objectOptional
Responses
200
Proof request accepted
application/json
Responseall of
400
Invalid parameters
application/json
404
Proof request was not found.
application/json
post
POST /proof-requests/{id}/send-presentation HTTP/1.1
Host: api-testnet.truvera.io
Content-Type: application/json
Accept: */*
Content-Length: 6816

{
  "description": "Verifiable Presentation that has been signed",
  "type": "object",
  "properties": {
    "@context": {
      "description": "JSON-LD context array of strings or single string",
      "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "object"
              }
            ]
          }
        },
        {
          "type": "string"
        }
      ]
    },
    "id": {
      "type": "string",
      "format": "uri"
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "verifiableCredential": {
      "oneOf": [
        {
          "type": "object",
          "description": "Verifiable (signed) Credential returned by API. The current set of properties is almost complete",
          "properties": {
            "@context": {
              "description": "JSON-LD context array of strings or single string",
              "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
              "oneOf": [
                {
                  "type": "array",
                  "items": {
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object"
                      }
                    ]
                  }
                },
                {
                  "type": "string"
                }
              ]
            },
            "id": {
              "type": "string"
            },
            "type": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "credentialSubject": {
              "oneOf": [
                {
                  "type": "object"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              ]
            },
            "issuer": {
              "oneOf": [
                {
                  "type": "string",
                  "description": "DID as fully qualified, typically. `did:cheqd:`",
                  "minimum": 32,
                  "example": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
                },
                {
                  "type": "object"
                }
              ]
            },
            "issuanceDate": {
              "type": "string",
              "format": "date-time"
            },
            "expirationDate": {
              "type": "string",
              "format": "date-time"
            },
            "credentialStatus": {
              "description": "Revocation registry id or user supplied status object",
              "oneOf": [
                {
                  "type": "object"
                },
                {
                  "type": "string"
                }
              ]
            },
            "proof": {
              "oneOf": [
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
                      "type": "string",
                      "enum": [
                        "Ed25519Signature2018",
                        "Ed25519Signature2020",
                        "Bls12381BBS+SignatureDock2022",
                        "Bls12381BBS+SignatureProofDock2022",
                        "Bls12381BBDT16MACDock2024",
                        "Bls12381BBSSignatureDock2023",
                        "Bls12381BBSVerificationKeyDock2023",
                        "BJJSignature2021",
                        "EcdsaSecp256k1Signature2019",
                        "Sr25519Signature2020"
                      ]
                    },
                    "proofPurpose": {
                      "description": "Purpose of credential",
                      "type": "string",
                      "enum": [
                        "assertionMethod",
                        "authentication"
                      ]
                    },
                    "verificationMethod": {
                      "type": "string"
                    },
                    "created": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "proofValue": {
                      "type": "string"
                    }
                  }
                },
                {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
                        "type": "string",
                        "enum": [
                          "Ed25519Signature2018",
                          "Ed25519Signature2020",
                          "Bls12381BBS+SignatureDock2022",
                          "Bls12381BBS+SignatureProofDock2022",
                          "Bls12381BBDT16MACDock2024",
                          "Bls12381BBSSignatureDock2023",
                          "Bls12381BBSVerificationKeyDock2023",
                          "BJJSignature2021",
                          "EcdsaSecp256k1Signature2019",
                          "Sr25519Signature2020"
                        ]
                      },
                      "proofPurpose": {
                        "description": "Purpose of credential",
                        "type": "string",
                        "enum": [
                          "assertionMethod",
                          "authentication"
                        ]
                      },
                      "verificationMethod": {
                        "type": "string"
                      },
                      "created": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "proofValue": {
                        "type": "string"
                      }
                    }
                  }
                }
              ]
            }
          }
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "description": "Verifiable (signed) Credential returned by API. The current set of properties is almost complete",
            "properties": {
              "@context": {
                "description": "JSON-LD context array of strings or single string",
                "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
                "oneOf": [
                  {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "object"
                        }
                      ]
                    }
                  },
                  {
                    "type": "string"
                  }
                ]
              },
              "id": {
                "type": "string"
              },
              "type": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "credentialSubject": {
                "oneOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  }
                ]
              },
              "issuer": {
                "oneOf": [
                  {
                    "type": "string",
                    "description": "DID as fully qualified, typically. `did:cheqd:`",
                    "minimum": 32,
                    "example": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59"
                  },
                  {
                    "type": "object"
                  }
                ]
              },
              "issuanceDate": {
                "type": "string",
                "format": "date-time"
              },
              "expirationDate": {
                "type": "string",
                "format": "date-time"
              },
              "credentialStatus": {
                "description": "Revocation registry id or user supplied status object",
                "oneOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "string"
                  }
                ]
              },
              "proof": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "type": {
                        "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
                        "type": "string",
                        "enum": [
                          "Ed25519Signature2018",
                          "Ed25519Signature2020",
                          "Bls12381BBS+SignatureDock2022",
                          "Bls12381BBS+SignatureProofDock2022",
                          "Bls12381BBDT16MACDock2024",
                          "Bls12381BBSSignatureDock2023",
                          "Bls12381BBSVerificationKeyDock2023",
                          "BJJSignature2021",
                          "EcdsaSecp256k1Signature2019",
                          "Sr25519Signature2020"
                        ]
                      },
                      "proofPurpose": {
                        "description": "Purpose of credential",
                        "type": "string",
                        "enum": [
                          "assertionMethod",
                          "authentication"
                        ]
                      },
                      "verificationMethod": {
                        "type": "string"
                      },
                      "created": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "proofValue": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
                          "type": "string",
                          "enum": [
                            "Ed25519Signature2018",
                            "Ed25519Signature2020",
                            "Bls12381BBS+SignatureDock2022",
                            "Bls12381BBS+SignatureProofDock2022",
                            "Bls12381BBDT16MACDock2024",
                            "Bls12381BBSSignatureDock2023",
                            "Bls12381BBSVerificationKeyDock2023",
                            "BJJSignature2021",
                            "EcdsaSecp256k1Signature2019",
                            "Sr25519Signature2020"
                          ]
                        },
                        "proofPurpose": {
                          "description": "Purpose of credential",
                          "type": "string",
                          "enum": [
                            "assertionMethod",
                            "authentication"
                          ]
                        },
                        "verificationMethod": {
                          "type": "string"
                        },
                        "created": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "proofValue": {
                          "type": "string"
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        }
      ]
    },
    "proof": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
              "type": "string",
              "enum": [
                "Ed25519Signature2018",
                "Ed25519Signature2020",
                "Bls12381BBS+SignatureDock2022",
                "Bls12381BBS+SignatureProofDock2022",
                "Bls12381BBDT16MACDock2024",
                "Bls12381BBSSignatureDock2023",
                "Bls12381BBSVerificationKeyDock2023",
                "BJJSignature2021",
                "EcdsaSecp256k1Signature2019",
                "Sr25519Signature2020"
              ]
            },
            "proofPurpose": {
              "description": "Purpose of credential",
              "type": "string",
              "enum": [
                "assertionMethod",
                "authentication"
              ]
            },
            "verificationMethod": {
              "type": "string"
            },
            "created": {
              "type": "string",
              "format": "date-time"
            },
            "proofValue": {
              "type": "string"
            }
          }
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "description": "Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)",
                "type": "string",
                "enum": [
                  "Ed25519Signature2018",
                  "Ed25519Signature2020",
                  "Bls12381BBS+SignatureDock2022",
                  "Bls12381BBS+SignatureProofDock2022",
                  "Bls12381BBDT16MACDock2024",
                  "Bls12381BBSSignatureDock2023",
                  "Bls12381BBSVerificationKeyDock2023",
                  "BJJSignature2021",
                  "EcdsaSecp256k1Signature2019",
                  "Sr25519Signature2020"
                ]
              },
              "proofPurpose": {
                "description": "Purpose of credential",
                "type": "string",
                "enum": [
                  "assertionMethod",
                  "authentication"
                ]
              },
              "verificationMethod": {
                "type": "string"
              },
              "created": {
                "type": "string",
                "format": "date-time"
              },
              "proofValue": {
                "type": "string"
              }
            }
          }
        }
      ]
    }
  }
}
{
  "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"
}