Skip to main content
Here’s the game plan:
  1. Start a document verification by calling the start verification endpoint.
  2. Setup a webhook to receive notifications when the verification is complete.
  3. Retrieve the verification result using the retrieve verification endpoint.
All requests will use the base URL https://api.camber.so/v1. Make sure you have generated an API key (authentication token) from the Camber dashboard.

​
Start a verification

const BASE_URL = "https://api.camber.so/v1";
const headers = {
  Authorization: `Bearer ${API_KEY}`,
};
Important: Signed URLs should be valid for at least 10 minutes.
const body = {
  document: {
    type: "tuberculosis_test", // document type
    url: "https://example.com/tuberculosis_test.pdf", // signed url
    external_id: "document123",
  },
  person: {
    first_name: "John",
    last_name: "Doe",
    dob: "1990-01-01", // YYYY-MM-DD
    external_id: "person123", // user id in your system
  },
  external_id: "verification123", // optional unique identifier for the verification
};

const response = await fetch(`${BASE_URL}/document-verifications`, {
  method: "POST",
    body: JSON.stringify(body),
  }
);

if (!response.ok) {
  throw new Error(`HTTP error! status: ${response.status}`);
}

const data = await response.json();
console.log(data);

​
Setup a webhook server

import express from 'express';
import { Webhook } from "svix";

const secret = "whsec_...";

const app = express();

app.post('/webhook', (req, res) => {

    const wh = new Webhook(secret);
    const payload = wh.verify(req.body, req.headers['svix-signature'], req.headers['svix-timestamp']);
    console.log(payload);

  const event = msg.event_type;
  switch (event) {
    case "document_verification.completed":
      console.log("Document verification completed");
      break;
    case "document_verification.failed":
      console.log("Document verification failed");
      break;
  }

  // handle the webhook
  res.sendStatus(200);
});

​
Retrieve a verification

const id = payload.data.id;

const response = await fetch(`${BASE_URL}/document-verifications/${id}`, {
  headers,
});

if (!response.ok) {
  throw new Error(`HTTP error! status: ${response.status}`);
}

const result = await response.json();
const { decision, confidence, issues, data } = result;
console.log(decision, confidence, issues, data);
That’s it! You’ve now successfully run a document verification. The rest is up to you :)