Official client libraries

SDKs for every major stack

Drop in your API key and start verifying identities in your language of choice. Official libraries for TypeScript, Python, Go, and more.

Generated from our OpenAPI 3.1 spec — always in sync with the latest API surface.

Get your API key REST API docs

Available libraries

TypeScript / Node.js

Available

Full type safety with generated models from our OpenAPI spec. Supports ESM and CommonJS. Works in Node.js 18+ and edge runtimes.

npm install @proveium/sdk

Show example

import { ProveiumClient } from '@proveium/sdk';

const client = new ProveiumClient({ apiKey: process.env.PROVEIUM_API_KEY });

const request = await client.verificationRequests.create({
  policyId: 'pol_age_18_plus',
  redirectUri: 'https://yourapp.com/callback',
});

Python

Available

Python 3.9+ with Pydantic models, async support via httpx, and synchronous convenience wrappers. pip and Poetry compatible.

pip install proveium

Show example

import proveium

client = proveium.ProveiumClient(api_key=os.environ["PROVEIUM_API_KEY"])

request = client.verification_requests.create(
    policy_id="pol_age_18_plus",
    redirect_uri="https://yourapp.com/callback",
)

Available

Idiomatic Go module with full context support, retries with backoff, and JSON schema validation. Go 1.21+.

go get github.com/proveium/sdk-go

Show example

client := proveium.NewClient(
    os.Getenv("PROVEIUM_API_KEY"),
)

req, err := client.VerificationRequests.Create(ctx,
    &proveium.CreateVerificationRequestParams{
        PolicyID:    "pol_age_18_plus",
        RedirectURI: "https://yourapp.com/callback",
    },
)

Java / Kotlin

Coming soon

JVM library with Kotlin-first API surface and Java compatibility layer. Maven Central and Gradle compatible.

com.proveium:sdk:latest

Swift / iOS

Coming soon

Swift Package Manager compatible. Async/await native. Includes on-device helpers for the biometric consent flow.

swift package add proveium

React (hooks)

Coming soon

Drop-in React hooks and components. useVerification, useConsentStatus, and <VerificationGate /> out of the box.

npm install @proveium/react

SDK design principles

All Proveium SDKs share the same design philosophy regardless of language.

One interface across all verification types

Idiomatic for each language — no copy-paste ports

Generated from the OpenAPI spec — always in sync

Retries and backoff built in

Webhook signature verification helpers

MIT licensed — use anywhere

Ready in minutes

TypeScript / Node.js — quick start

# 1. Install
npm install @proveium/sdk

# 2. Create a verification request
import { ProveiumClient } from '@proveium/sdk';

const client = new ProveiumClient({
  apiKey: process.env.PROVEIUM_API_KEY,
});

const request = await client.verificationRequests.create({
  policyId: 'pol_age_18_plus',
  redirectUri: 'https://yourapp.com/verify/callback',
});

// 3. Redirect the user to request.verificationUrl
// 4. Handle the callback and retrieve the signed receipt

Get sandbox keys