Developer Central Guide | Virifi Help Center

What is a REST API, anyway?

API is short for 'Application Programming Interface' . An API is a set of rules that lets programs talk to each other, exposing data and functionality across the Internet in a consistent format.

REST stands for 'Representational State Transfer'. This is an architectural pattern that describes how distributed systems can expose a consistent interface. When people use the term 'REST API', they are generally referring to an API accessed using the HTTP protocol at a predefined set of URLs.

These URLs represent various resources — any information or content accessed at that location, which can be returned as JSON, HTML, audio files, or images. Often resources have one or more methods that can be performed on them over HTTP, like GET, POST, PUT, and DELETE. The action represented by the first and last of these is clear, but POST and PUT have specific meanings. How they are defined is confusing, but the general rule is: use POST to create resources, and PUT to update resources.

Working with Virifi's APIs

What you'll need

All the APIs uses Authorization header key. You can generate an API Key under Settings > Developer Central > Create API Key.

This API key is linked to the account you used to generate it. This means that all credit transactions completed via API will be reflected in the credit history under the credits section.

Let's get started

Base URL - https://virifi.io/api/developer

1. Ping

Method	`GET`
Endpoint	/ping
Description	This API is used to see if your integration is working properly.
Request headers	"Authorization": "Bearer API-KEY"
Request Body	No params
Successful Response	200 OK No Content
Possible Error Responses	1. 400 No API key found at this token 2. 400 API Key is deactive by owner user 3. 400 No user found 4. 400 Your organization is block by Virifi.io 4. 400 Jwt Malformed

2. Certify Document

Method	`POST`
Endpoint	/certify-document
Description	This API is used to certify document/s. At any given time, the maximum number of documents allowed is five.
Request headers	"ContentType": "multipart/form-data" "Authorization": "Bearer API-KEY"
Request Body	"folderName": string, "digitalTwin": Boolean, "totalDoc": string, "doc0": Blob, "doc1": Blob
Successful Response	200 OK, Certified PDF document to type Array Buffer.
Possible Error Responses	1. 400 No file Upload 2. 401 Missing Parameters 3. 401 Low Credit Balance 4. 401 Only 5 Documents

3. Sign Document

Method	`POST`
Endpoint	/sign-document
Description	This API is used to sign documents. The account owner's email address should be listed as the first entry in `signUser` key for "Sign By Yourself" and "Sign and Invite Others" options. In AES, account owner's contact number should be configured on the Virifi Platform under Profile section.
Request headers	"ContentType": "multipart/form-data" "Authorization": "Bearer API-KEY"
Request Body	Advance Electronic Signature (AES) "fileName": string, "digitalTwin": Boolean, "doc": Blob, "signBy": string 1. signByYouself 2. signAndInviteOthers 3. signOther "signUser": Array < Array >, "email": string "number": string "groupId": number "signatureType": "AES", "sendEmailToAllUsers": boolean Professional Electronic Signature (PES)
Successful Responses	200 OK 1. Signed PDF Array Buffer (Sign By Yourself). 2. E-KYB URL (For PES Type, Sign By Yourself and Sign and Invite Others). 3. PDF Sign successful message and email will be sent to others for their signatures. 4. Mail sent to others for their signatures message (Request Others Signature).
Possible Error Responses	1. 400 No file Upload 2. 401 Missing Parameters 3. 401 Low Credit Balance 4. 401 Number is not verified

4. Add Member

Method	`POST`
Endpoint	/add-member
Description	This API is used to add a member. Member will be registered as Third Party User with limited access to the platform. Member need to follow the invite link sent over the mail and proceed with next step to complete KYB verification and generate API keys.
Request headers	"ContentType": "application/json" "Authorization": "Bearer API-KEY"
Request Body	"firstName": string, "lastName": string, "email": string
Successful Responses	200 OK Invitation email sent on the requested email.
Possible Error Responses	1. 401 Missing Parameters 2. 401 Low Credit Balance 3. 401 Invitation Already Sent 4. 401 Only Business email 5. 401 User Already Exist

Create a Developer Key

A Developer Key allows your organization to connect securely to VIRIFI’s API and automate document certification, signing, or verification from your own applications or backend systems.

Follow these steps to create a new key:

1. Click “Settings”
To manage your account settings or access developer tools, click the profile dropdown and select Settings.

2. Click “Developer Central”
Inside Settings, navigate to Developer Central from the left-side menu.

3. Click “Create New Key”
Generate an API key to use with your integration.

4. Click the “Key Name” field
Enter a name for your new integration key (e.g., Integration A001).

5. Click “Create”
Your new API key will be generated and displayed in your Developer Central list.

💡 Tips

You can create multiple keys for different integrations (e.g., Zapier, internal automation, partner systems).
Revoke any API key at any time if it’s no longer in use.
Always store your API key securely — it provides access to your organization’s certified data.

Download Postman Collection

Virifi Postman Collection.json