vouch Docs

Start a new vouch verification

The fundamental pattern for initiating a vouch verification involves using the vouch SDK to generate a secure URL and redirect the user.

Using AI or LLMs with Vouch?

For best results add https://docs.getvouch.io/llms.txt to your model’s context.

Install the vouch SDK

Install the vouch SDK using your preferred package manager:

npm install @getvouch/sdk

yarn add @getvouch/sdk

pnpm add @getvouch/sdk

bun add @getvouch/sdk

Create vouch instance

Initialize the vouch SDK by creating a new instance:

import { Vouch } from "@getvouch/sdk";
const vouch = new Vouch();

Generate web proof URL with vouch

To generate a Web Proof, use the vouch SDK to create a verification URL and redirect the user:

Vouch URL Parameters

datasourceId

The UUID of the data source to use for this verification. Available data sources and their respective datasourceIds are listed in available data sources section and in the vouch catalog.

customerId

Your unique customerId is provided during account setup. Contact the vouch team to obtain your production customerId for live integrations.

redirectBackUrl

After the Web Proof is generated, the user will be redirected to this URL. This will usually be a page on your website where you can handle the response and display the result to the user.

You will likely want to use the requestId query parameter to identify the request and retrieve the Web Proof from your server. In this case, the requestId needs to be included manually to the redirectBackUrl in a way that suits your application needs.

webhookUrl

This is an optional parameter. If provided, vouch will send a POST request to this URL with the generated Web Proof once the verification process is complete.

Make sure your webhook handler is capable of processing POST requests. The requests will have a Content-Type of application/json, and the request body matches the webhook payload.

It is recommended to independently verify the cryptographic proof by passing the presentationJson object from the webhook to our server for verification.

inputs

The inputs parameter is a string that holds proof request parameters. Examples include a link to a tweet or a required minimum bank balance. Input values must be primitive types: string, number, boolean, null, undefined, symbol, or bigint.

You must serialize the input as JSON and then encode it using base64. The next section explains how to do this.

First steps