SDKs & Libraries

Official HeyVisa client libraries wrap authentication, retries, typed models, and webhook signature verification so you can call the visa intelligence API without hand-rolling HTTP. Pick the library for your stack below.

Available libraries

Language	Package	Status	Min runtime
JavaScript / TypeScript	`@heyvisa/sdk`	Stable	Node 18+, Deno, Bun
Python	`heyvisa`	Stable	Python 3.9+
Go	`heyvisa-go`	Beta	Go 1.21+

All libraries are typed end-to-end, default to exponential backoff on 429 and 5xx, and read HEYVISA_API_KEY from the environment when no key is passed explicitly.

JavaScript / TypeScript

Install

bash

npm install @heyvisa/sdk
# or
pnpm add @heyvisa/sdk
# or
yarn add @heyvisa/sdk

Quickstart

import { HeyVisa } from "@heyvisa/sdk";

const client = new HeyVisa({ apiKey: process.env.HEYVISA_API_KEY! });

const report = await client.reports.create({
  purpose: "tourism",
  destination: "DE",
  documents: ["doc_01HXYZpassport", "doc_01HXYZbank"],
});

console.log(report.riskScore, report.recommendations);

Python

Install

bash

pip install heyvisa
# or
uv add heyvisa

Quickstart

python

from heyvisa import HeyVisa

client = HeyVisa(api_key=os.environ["HEYVISA_API_KEY"])

report = client.reports.create(
    purpose="tourism",
    destination="DE",
    documents=["doc_01HXYZpassport", "doc_01HXYZbank"],
)

print(report.risk_score, report.recommendations)

Use a test key first

Both quickstarts work unchanged against the sandbox — set HEYVISA_API_KEY to an sk_test_ key to develop without consuming quota, then swap in your live key for production.