Other proof endpoints

Send a presentation to the proof request

Sends presentation to proof request

Sends a presentation to the request

POSThttps://api-testnet.truvera.io/proof-requests/{id}/send-presentation

Path parameters

id*string (uuid)

Proof request UUID

Body

application/json

Specify action and credential ids

object

Response

200400404

Proof request accepted

Body

application/json

id*string (uuid)

The unique identifier for the proof request.

Example: "37275574-7ea4-438d-b8ef-f8fc61dbf09e"

attributesobject

Requested attribute specifications of proof request

namestring

Proof request name

Example: "Proof request"

noncestring

Nonce or challenge for the presentation to match

Example: "1234567890"

errorstring

response_url*string (uri)

The URL to send the proof presentation response.

Example: "http://api-testnet.truvera.io/proof-requests/37275574-7ea4-438d-b8ef-f8fc61dbf09e/send-presentation"

qrstring

QR code deep link for mobile wallet scanning

Example: "http://creds-testnet.truvera.io/proof/37275574-7ea4-438d-b8ef-f8fc61dbf09e"

didDID (string)

DID as fully qualified, typically. did:dock:

Example: "did:dock:xyz"

verifiedboolean

Indicates whether the proof request has been verified.

Example: false

presentationobject

created*string (date-time)

The timestamp when the proof request was created.

Example: "2024-09-26T12:38:10.871Z"

updatedstring (date-time)

The timestamp when the proof request was last updated.

Example: "2024-09-26T12:38:10.871Z"

requestobject

The actual details of the proof request.

typestring

The type of the request.

Example: "proof-request"

typesarray of string

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

verifierNamestring

The name of the verifier.

Example: "Truvera"

verifierLogostring

The logo of the verifier.

Example: "https://logo.truvera.io/verifier"

Request

JavaScriptCurlPython

const response = await fetch('https://api-testnet.truvera.io/proof-requests/{id}/send-presentation', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "description": "<p>Verifiable Presentation that has been signed</p>",
      "type": "object",
      "properties": {
        "@context": {
          "description": "<p>JSON-LD context array of strings or single string</p>",
          "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
          "oneOf": [
            {
              "type": "array",
              "items": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "object"
                  }
                ]
              }
            },
            {
              "type": "string"
            }
          ],
          "__$markdownParsed": true,
          "__$refResolved": "Context"
        },
        "id": {
          "type": "string",
          "format": "uri"
        },
        "type": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "verifiableCredential": {
          "oneOf": [
            {
              "description": "<p>Verifiable (signed) Credential returned by API. The current set of properties is almost complete</p>",
              "type": "object",
              "properties": {
                "@context": {
                  "description": "<p>JSON-LD context array of strings or single string</p>",
                  "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
                  "oneOf": [
                    {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "object"
                          }
                        ]
                      }
                    },
                    {
                      "type": "string"
                    }
                  ],
                  "__$markdownParsed": true,
                  "__$refResolved": "Context"
                },
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "credentialSubject": {
                  "oneOf": [
                    {
                      "type": "object"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  ]
                },
                "issuer": {
                  "oneOf": [
                    {
                      "description": "<p>DID as fully qualified, typically. <code>did:dock:</code></p>",
                      "type": "string",
                      "minimum": 32,
                      "example": "did:dock:xyz",
                      "__$markdownParsed": true,
                      "__$refResolved": "DID"
                    },
                    {
                      "type": "object"
                    }
                  ]
                },
                "issuanceDate": {
                  "type": "string",
                  "format": "date-time"
                },
                "expirationDate": {
                  "type": "string",
                  "format": "date-time"
                },
                "credentialStatus": {
                  "description": "<p>Revocation registry id or user supplied status object</p>",
                  "oneOf": [
                    {
                      "type": "object"
                    },
                    {
                      "type": "string"
                    }
                  ],
                  "__$markdownParsed": true
                },
                "proof": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                          "type": "string",
                          "enum": [
                            "Ed25519Signature2018",
                            "Ed25519Signature2020",
                            "Bls12381BBS+SignatureDock2022",
                            "Bls12381BBS+SignatureProofDock2022",
                            "Bls12381BBDT16MACDock2024",
                            "Bls12381BBSSignatureDock2023",
                            "Bls12381BBSVerificationKeyDock2023",
                            "BJJSignature2021",
                            "EcdsaSecp256k1Signature2019",
                            "Sr25519Signature2020"
                          ],
                          "__$markdownParsed": true,
                          "__$refResolved": "SigType"
                        },
                        "proofPurpose": {
                          "description": "<p>Purpose of credential</p>",
                          "type": "string",
                          "enum": [
                            "assertionMethod",
                            "authentication"
                          ],
                          "__$markdownParsed": true,
                          "__$refResolved": "ProofPurpose"
                        },
                        "verificationMethod": {
                          "type": "string"
                        },
                        "created": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "proofValue": {
                          "type": "string"
                        }
                      },
                      "__$refResolved": "VerifiableProof"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                            "type": "string",
                            "enum": [
                              "Ed25519Signature2018",
                              "Ed25519Signature2020",
                              "Bls12381BBS+SignatureDock2022",
                              "Bls12381BBS+SignatureProofDock2022",
                              "Bls12381BBDT16MACDock2024",
                              "Bls12381BBSSignatureDock2023",
                              "Bls12381BBSVerificationKeyDock2023",
                              "BJJSignature2021",
                              "EcdsaSecp256k1Signature2019",
                              "Sr25519Signature2020"
                            ],
                            "__$markdownParsed": true,
                            "__$refResolved": "SigType"
                          },
                          "proofPurpose": {
                            "description": "<p>Purpose of credential</p>",
                            "type": "string",
                            "enum": [
                              "assertionMethod",
                              "authentication"
                            ],
                            "__$markdownParsed": true,
                            "__$refResolved": "ProofPurpose"
                          },
                          "verificationMethod": {
                            "type": "string"
                          },
                          "created": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "proofValue": {
                            "type": "string"
                          }
                        },
                        "__$refResolved": "VerifiableProof"
                      }
                    }
                  ]
                }
              },
              "__$markdownParsed": true,
              "__$refResolved": "VerifiableCredential"
            },
            {
              "type": "array",
              "items": {
                "description": "<p>Verifiable (signed) Credential returned by API. The current set of properties is almost complete</p>",
                "type": "object",
                "properties": {
                  "@context": {
                    "description": "<p>JSON-LD context array of strings or single string</p>",
                    "example": "https://docknetwork.github.io/vc-schemas/basic-credential.json-ld",
                    "oneOf": [
                      {
                        "type": "array",
                        "items": {
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "object"
                            }
                          ]
                        }
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "__$markdownParsed": true,
                    "__$refResolved": "Context"
                  },
                  "id": {
                    "type": "string"
                  },
                  "type": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "credentialSubject": {
                    "oneOf": [
                      {
                        "type": "object"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "object"
                        }
                      }
                    ]
                  },
                  "issuer": {
                    "oneOf": [
                      {
                        "description": "<p>DID as fully qualified, typically. <code>did:dock:</code></p>",
                        "type": "string",
                        "minimum": 32,
                        "example": "did:dock:xyz",
                        "__$markdownParsed": true,
                        "__$refResolved": "DID"
                      },
                      {
                        "type": "object"
                      }
                    ]
                  },
                  "issuanceDate": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "expirationDate": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "credentialStatus": {
                    "description": "<p>Revocation registry id or user supplied status object</p>",
                    "oneOf": [
                      {
                        "type": "object"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "__$markdownParsed": true
                  },
                  "proof": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                            "type": "string",
                            "enum": [
                              "Ed25519Signature2018",
                              "Ed25519Signature2020",
                              "Bls12381BBS+SignatureDock2022",
                              "Bls12381BBS+SignatureProofDock2022",
                              "Bls12381BBDT16MACDock2024",
                              "Bls12381BBSSignatureDock2023",
                              "Bls12381BBSVerificationKeyDock2023",
                              "BJJSignature2021",
                              "EcdsaSecp256k1Signature2019",
                              "Sr25519Signature2020"
                            ],
                            "__$markdownParsed": true,
                            "__$refResolved": "SigType"
                          },
                          "proofPurpose": {
                            "description": "<p>Purpose of credential</p>",
                            "type": "string",
                            "enum": [
                              "assertionMethod",
                              "authentication"
                            ],
                            "__$markdownParsed": true,
                            "__$refResolved": "ProofPurpose"
                          },
                          "verificationMethod": {
                            "type": "string"
                          },
                          "created": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "proofValue": {
                            "type": "string"
                          }
                        },
                        "__$refResolved": "VerifiableProof"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                              "type": "string",
                              "enum": [
                                "Ed25519Signature2018",
                                "Ed25519Signature2020",
                                "Bls12381BBS+SignatureDock2022",
                                "Bls12381BBS+SignatureProofDock2022",
                                "Bls12381BBDT16MACDock2024",
                                "Bls12381BBSSignatureDock2023",
                                "Bls12381BBSVerificationKeyDock2023",
                                "BJJSignature2021",
                                "EcdsaSecp256k1Signature2019",
                                "Sr25519Signature2020"
                              ],
                              "__$markdownParsed": true,
                              "__$refResolved": "SigType"
                            },
                            "proofPurpose": {
                              "description": "<p>Purpose of credential</p>",
                              "type": "string",
                              "enum": [
                                "assertionMethod",
                                "authentication"
                              ],
                              "__$markdownParsed": true,
                              "__$refResolved": "ProofPurpose"
                            },
                            "verificationMethod": {
                              "type": "string"
                            },
                            "created": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "proofValue": {
                              "type": "string"
                            }
                          },
                          "__$refResolved": "VerifiableProof"
                        }
                      }
                    ]
                  }
                },
                "__$markdownParsed": true,
                "__$refResolved": "VerifiableCredential"
              }
            }
          ]
        },
        "proof": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "type": {
                  "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                  "type": "string",
                  "enum": [
                    "Ed25519Signature2018",
                    "Ed25519Signature2020",
                    "Bls12381BBS+SignatureDock2022",
                    "Bls12381BBS+SignatureProofDock2022",
                    "Bls12381BBDT16MACDock2024",
                    "Bls12381BBSSignatureDock2023",
                    "Bls12381BBSVerificationKeyDock2023",
                    "BJJSignature2021",
                    "EcdsaSecp256k1Signature2019",
                    "Sr25519Signature2020"
                  ],
                  "__$markdownParsed": true,
                  "__$refResolved": "SigType"
                },
                "proofPurpose": {
                  "description": "<p>Purpose of credential</p>",
                  "type": "string",
                  "enum": [
                    "assertionMethod",
                    "authentication"
                  ],
                  "__$markdownParsed": true,
                  "__$refResolved": "ProofPurpose"
                },
                "verificationMethod": {
                  "type": "string"
                },
                "created": {
                  "type": "string",
                  "format": "date-time"
                },
                "proofValue": {
                  "type": "string"
                }
              },
              "__$refResolved": "VerifiableProof"
            },
            {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "description": "<p>Type of signature (NOTE: EcdsaSecp256k1Signature2019, Sr25519Signature2020 are deprecated)</p>",
                    "type": "string",
                    "enum": [
                      "Ed25519Signature2018",
                      "Ed25519Signature2020",
                      "Bls12381BBS+SignatureDock2022",
                      "Bls12381BBS+SignatureProofDock2022",
                      "Bls12381BBDT16MACDock2024",
                      "Bls12381BBSSignatureDock2023",
                      "Bls12381BBSVerificationKeyDock2023",
                      "BJJSignature2021",
                      "EcdsaSecp256k1Signature2019",
                      "Sr25519Signature2020"
                    ],
                    "__$markdownParsed": true,
                    "__$refResolved": "SigType"
                  },
                  "proofPurpose": {
                    "description": "<p>Purpose of credential</p>",
                    "type": "string",
                    "enum": [
                      "assertionMethod",
                      "authentication"
                    ],
                    "__$markdownParsed": true,
                    "__$refResolved": "ProofPurpose"
                  },
                  "verificationMethod": {
                    "type": "string"
                  },
                  "created": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "proofValue": {
                    "type": "string"
                  }
                },
                "__$refResolved": "VerifiableProof"
              }
            }
          ]
        }
      },
      "__$markdownParsed": true,
      "__$refResolved": "VerifiablePresentation"
    }),
});
const data = await response.json();

Response

200400404

{
  "id": "37275574-7ea4-438d-b8ef-f8fc61dbf09e",
  "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:dock:xyz",
  "verified": false,
  "created": "2024-09-26T12:38:10.871Z",
  "updated": "2024-09-26T12:38:10.871Z",
  "request": {
    "name": "test request",
    "purpose": "my purpose"
  },
  "type": "proof-request",
  "types": [
    "jsonld"
  ],
  "verifierName": "Truvera",
  "verifierLogo": "https://logo.truvera.io/verifier"
}

Get the proof request PEX definition

Get the proof request PEX definition

Get the proof request PEX definition

GEThttps://api-testnet.truvera.io/proof-requests/{id}/pex

Path parameters

id*string (uuid)

OpenID issuer UUID

Response

200400404

The proof request PEX definition

Body

application/json

object

Request

JavaScriptCurlPython

const response = await fetch('https://api-testnet.truvera.io/proof-requests/{id}/pex', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400404

{
  "status": 0,
  "type": "text",
  "message": "text"
}