Is there a VerifyAI Node.js SDK?

No. VerifyAI is a plain HTTPS/JSON API and Node 18+ has everything needed built in, so the examples on this page are the whole integration: no package to install, pin or audit. For in-app camera capture, use the React Native or Flutter SDK.

Does this work with TypeScript?

Yes. The JavaScript / TypeScript docs page includes an interface for the verification response that you can copy into your project, and the Next.js webhook receiver above is TypeScript.

How do I verify webhook signatures?

Read the raw body (express.raw in Express, await req.text() in a Next.js route), take t and v1 from X-VerifyAI-Signature, compute HMAC-SHA256 of t + '.' + raw body with your signing secret, and compare it to v1 with crypto.timingSafeEqual. Reject a t more than five minutes from your clock, and deduplicate on X-VerifyAI-Delivery.

How should I retry failed requests?

Retry 429 and 5xx responses with backoff, wait the Retry-After seconds on a 429, and reuse one Idempotency-Key across a request's retries so the check runs once. Other 4xx responses won't succeed on retry; fix the request instead.

Can I use Fastify or another framework?

Yes. Any framework works as long as the webhook route receives the raw request body. In Fastify, add a content-type parser for application/json that keeps the body as a Buffer, and pass that Buffer to the same verify function.

VerifyAI Node.js Integration

Call the VerifyAI REST API from your Node.js backend with the fetch and FormData built into Node 18+. There is no Node package to install: the examples below are plain HTTPS, and the webhook receiver is run against real signed deliveries in our test suite.

Try Live Demo Contact Sales

Quick Start

1. Install

bash

# No VerifyAI package to install: Node 18+ ships fetch, FormData and Blob.
# Keep your API key on the server.
export VERIFY_AI_KEY=vai_your_api_key

2. Use

javascript

import fs from "node:fs";

const form = new FormData();
form.set("image", new Blob([fs.readFileSync("photo.jpg")], { type: "image/jpeg" }), "photo.jpg");
form.set("policy", "scooter_parking");
form.set("metadata", JSON.stringify({ trip_id: "trip_123" }));

const res = await fetch("https://verify.switchlabs.dev/api/v1/verify", {
  method: "POST",
  headers: { "X-API-Key": process.env.VERIFY_AI_KEY },
  body: form,
});
const result = await res.json();
if (!res.ok) throw new Error("VerifyAI " + res.status + ": " + result.error);

if (result.is_compliant) {
  console.log("Verified:", result.id);
} else {
  console.log("Issue:", result.feedback, result.violation_reasons);
}

Features

Plain HTTPS

One POST to /api/v1/verify with an X-API-Key header. Works with fetch, undici, axios or got, with nothing VerifyAI-specific to install or upgrade.

Multipart or JSON

Send the photo as a multipart file, or as base64 in a JSON body when it reached your server that way from a mobile client.

Stable JSON Response

Branch on is_compliant, violation_reasons, feedback and confidence. The docs include a TypeScript interface for the response you can copy into your project.

Idempotent Retries

Send an Idempotency-Key header and a retried request returns the original result instead of running, and billing, the check twice.

Tested Webhook Receiver

Verify X-VerifyAI-Signature over the raw body with node:crypto. The Express and Next.js receivers below run against real signed deliveries in our test suite.

Clear Rate Limits

A 429 carries Retry-After in seconds, and every response carries an X-Request-Id you can quote to support.

Code Examples

Requirements

Node.js 18 or higher (built-in fetch, FormData and Blob)
A VerifyAI API key (vai_…), kept on your server
Express and multer only if you use the upload example
Your webhook signing secret (whsec_…) for the receiver

Frequently Asked Questions

Start Building with Node.js

Get an API key and send your first verification with a single fetch call.