https://api-production-b0c5.up.railway.app

curl https://api-production-b0c5.up.railway.app/v1/verifications \
  -H "Authorization: Bearer your_api_key"

curl -X POST https://api-production-b0c5.up.railway.app/v1/verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "passport",
    "document_front": "<base64_image>",
    "selfie": "<base64_image>",
    "reference_id": "user_abc123"
  }'

# Response:
# {
#   "id": "ver_a1b2c3d4",
#   "status": "pending",
#   "reference_id": "user_abc123",
#   "created_at": "2026-04-08T12:00:00Z"
# }

curl https://api-production-b0c5.up.railway.app/v1/verifications/ver_a1b2c3d4 \
  -H "Authorization: Bearer your_api_key"

# Response:
# {
#   "id": "ver_a1b2c3d4",
#   "status": "approved",
#   "risk_score": 12,
#   "sanctions_hit": false,
#   "name": "Jane Smith",
#   "nationality": "US",
#   "completed_at": "2026-04-08T12:00:02Z"
# }

curl -X POST https://api-production-b0c5.up.railway.app/v1/verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "passport",
    "document_front": "<base64_image>",
    "selfie": "<base64_image>",
    "reference_id": "user_abc123"
  }'

{
  "id": "ver_a1b2c3d4",
  "status": "pending",
  "reference_id": "user_abc123",
  "document_type": "passport",
  "created_at": "2026-04-08T12:00:00Z"
}

curl https://api-production-b0c5.up.railway.app/v1/verifications/ver_a1b2c3d4 \
  -H "Authorization: Bearer your_api_key"

{
  "id": "ver_a1b2c3d4",
  "status": "approved",
  "reference_id": "user_abc123",
  "document_type": "passport",
  "risk_score": 12,
  "sanctions_hit": false,
  "name": "Jane Smith",
  "date_of_birth": "1990-05-14",
  "nationality": "US",
  "document_number": "A12345678",
  "document_expiry": "2030-01-01",
  "created_at": "2026-04-08T12:00:00Z",
  "completed_at": "2026-04-08T12:00:02Z"
}

curl -X POST https://api-production-b0c5.up.railway.app/v1/sanctions/screen \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "date_of_birth": "1990-05-14",
    "nationality": "US"
  }'

{
  "id": "scr_x1y2z3w4",
  "status": "clear",
  "matches": [],
  "screened_at": "2026-04-08T12:00:00Z"
}

// If a potential match is found:
{
  "id": "scr_x1y2z3w4",
  "status": "potential_match",
  "matches": [
    {
      "list": "OFAC SDN",
      "name": "Jane A. Smith",
      "fuzzy_score": 0.91,
      "entity_type": "individual",
      "additional_info": "Sanctioned entity — see OFAC reference #12345"
    }
  ],
  "screened_at": "2026-04-08T12:00:00Z"
}

curl -X POST https://api-production-b0c5.up.railway.app/v1/billing/checkout \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "growth",
    "email": "user@example.com",
    "success_url": "https://example.com/dashboard",
    "cancel_url": "https://example.com/pricing"
  }'

{
  "checkout_url": "https://checkout.paddle.com/checkout/...",
  "expires_at": "2026-04-08T13:00:00Z"
}

npm install @veridian/sdk

import VeridianClient from '@veridian/sdk'

const veridian = new VeridianClient(process.env.VERIDIAN_API_KEY!)

// Sandbox mode
const sandbox = new VeridianClient(process.env.VERIDIAN_TEST_KEY!)

const verification = await veridian.createVerification({
  documentType: 'passport',
  documentFront: documentBase64,
  selfie: selfieBase64,
  referenceId: userId,
})

// Poll for result
const result = await veridian.getVerification(verification.id)

if (result.status === 'approved') {
  console.log('Verified:', result.name, result.nationality)
  console.log('Risk score:', result.riskScore) // 0–100
  console.log('Sanctions hit:', result.sanctionsHit) // boolean
}

const screen = await veridian.screenSanctions({
  name: 'Jane Smith',
  dateOfBirth: '1990-05-14',
  nationality: 'US',
})

if (screen.status === 'clear') {
  console.log('No sanctions matches found')
} else {
  console.log('Potential matches:', screen.matches)
}

import { VeridianWebhookEvent } from '@veridian/sdk'

// Type-safe webhook handling
function handleWebhook(event: VeridianWebhookEvent) {
  switch (event.type) {
    case 'verification.completed':
      console.log(event.data.status) // 'approved' | 'rejected' | 'review'
      break
    case 'verification.flagged':
      console.log(event.data.reason)
      break
  }
}

pip install veridian-kyc

from veridian import VeridianClient
import os

client = VeridianClient(os.environ["VERIDIAN_API_KEY"])

# Async client
from veridian.async_client import AsyncVeridianClient
async_client = AsyncVeridianClient(os.environ["VERIDIAN_API_KEY"])

verification = client.create_verification(
    document_type="passport",
    document_front=document_base64,
    selfie=selfie_base64,
    reference_id=user_id,
)

# Poll for result
result = client.get_verification(verification.id)

if result.status == "approved":
    print(f"Verified: {result.name}, {result.nationality}")
    print(f"Risk score: {result.risk_score}")  # 0-100
    print(f"Sanctions hit: {result.sanctions_hit}")  # bool

import asyncio
from veridian.async_client import AsyncVeridianClient

async def verify_user(document_b64: str, selfie_b64: str) -> dict:
    async with AsyncVeridianClient(api_key) as client:
        verification = await client.create_verification(
            document_type="passport",
            document_front=document_b64,
            selfie=selfie_b64,
        )
        return await client.get_verification(verification.id)

result = asyncio.run(verify_user(doc, selfie))

{
  "id": "evt_p9q8r7s6",
  "type": "verification.completed",
  "created_at": "2026-04-08T12:00:02Z",
  "data": {
    "verification_id": "ver_a1b2c3d4",
    "status": "approved",
    "reference_id": "user_abc123",
    "risk_score": 12,
    "sanctions_hit": false
  }
}

const crypto = require('crypto')

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex')

  // Use timingSafeEqual to prevent timing attacks
  const expectedBuf = Buffer.from(expected, 'hex')
  const sigBuf = Buffer.from(signature, 'hex')

  if (expectedBuf.length !== sigBuf.length) return false
  return crypto.timingSafeEqual(expectedBuf, sigBuf)
}

// Express example
app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-veridian-signature']
  if (!verifyWebhook(req.body, sig, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature')
  }
  const event = JSON.parse(req.body)
  // handle event...
  res.status(200).send('OK')
})

{
  "error": {
    "code": "invalid_document",
    "message": "The document image could not be processed. Ensure the image is clear, well-lit, and under 10MB.",
    "request_id": "req_abc123xyz"
  }
}

import { VeridianError } from '@veridian/sdk'

try {
  const result = await veridian.createVerification({ ... })
} catch (err) {
  if (err instanceof VeridianError) {
    console.error(err.code)       // 'invalid_document'
    console.error(err.message)    // Human-readable description
    console.error(err.requestId)  // For support tickets
    console.error(err.status)     // HTTP status code

    if (err.code === 'insufficient_funds') {
      // redirect user to upgrade page
    }
  }
}