Integrate VerfiX in minutes

Make your first verification

Create a sandbox API key from your VerfiX dashboard, then call the verification endpoint. Every request is authenticated with a bearer token and returns a Trust Score with an explainable signal breakdown.

curl https://api.verfix.ch/v1/verifications \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "kyc",
    "person": { "first_name": "Anna", "last_name": "Keller", "country": "CH" },
    "checks": ["document", "face", "aml"]
  }'

Bearer tokens

VerfiX uses API keys scoped per environment. Pass your secret key in the Authorization header. Never expose secret keys in client-side code — use the publishable key for hosted flows and the secret key server-side only.

Sandbox & production

The sandbox mirrors production behaviour with deterministic test fixtures so you can simulate approvals, reviews, and rejections. All data is hosted in Switzerland.

KYC — Verify a person

Run document verification, face match, liveness, and AML screening in a single call. Returns a verification object with a Trust Score and per-signal results.

{
  "id": "ver_8f2a...",
  "type": "kyc",
  "status": "approved",
  "trust_score": 92,
  "signals": {
    "document": "pass",
    "face_match": "pass",
    "liveness": "pass",
    "aml": "clear"
  },
  "created_at": "2027-06-19T10:24:00Z"
}

KYB — Verify a company

Resolve a legal entity against commercial registries, extract directors and ultimate beneficial owners, and screen the structure for sanctions and adverse media.

curl https://api.verfix.ch/v1/companies \
  -H "Authorization: Bearer sk_live_..." \
  -d '{ "name": "Example AG", "country": "CH", "registry_id": "CHE-123.456.789" }'

AML — Screening

Screen names against sanctions lists, PEP databases, and adverse media. Configure match thresholds and ongoing monitoring through the Rules Builder.

curl https://api.verfix.ch/v1/screenings \
  -H "Authorization: Bearer sk_live_..." \
  -d '{ "name": "Anna Keller", "country": "CH", "lists": ["sanctions","pep","adverse_media"] }'

Event notifications

Subscribe to verification lifecycle events. VerfiX signs every payload with an HMAC signature in the VerfiX-Signature header — verify it before trusting the body.

Official libraries

Error reference

Throughput

Sandbox is limited to 60 requests/minute. Production limits are set per contract — enterprise plans include burst capacity and dedicated throughput. A 429 response includes a Retry-After header.