Missing a country or a custom check? Tell us what you need.Book a 15-min call

Developers

Verify a person with one API call.

Your backend creates a session, the person verifies on a hosted page or in an embedded frame, and the result comes back by webhook and as a signed result.

The full API reference is public at app.secuveri.com/docs.

curl -X POST https://api.secuveri.com/v1/sessions \
  -H "x-api-key: $SECUVERI_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: signup-1042" \
  -d '{
    "workflow_id": "wf_kyc_standard",
    "vendor_data": "customer-1042"
  }'

201Response

{
  "verification_id": "VRF-7KQ2M9XA",
  "status": "CREATED",
  "url": "https://verify.secuveri.com/verification/VRF-7KQ2M9XA?t=…"
}

Quick start

Live in three steps.

  1. 01

    Create an API key

    In Settings, API keys. sk_test_ runs the sandbox, sk_live_ production. Keys stay on your server.

  2. 02

    Create a session

    POST /v1/sessions returns a link. Redirect, show a QR code, or let us send it by email or SMS.

  3. 03

    Receive the result

    A signed webhook tells you it's done. Read the signed result for the outcome and every check.

Standalone APIs

Use each API on its own.

Every check is also sold as its own API, outside a verification flow. Each is marked with its real status.

Available

Document verification

Read and check an ID document and its NFC chip.

Available

Face match

Compare two face images.

Available

Liveness

Check that a selfie shows a live person.

Available

Age estimation

Estimate age from a face image.

Available

AML screening

Screen a person against sanctions and PEP lists with POST /v1/aml/screen.

Available

Proof of address

Read a utility bill or statement for your review.

Available

Content Credentials (C2PA)

Validate the Content Credentials in an image with the secuveri C2PA Validator.

Available

Business verification (KYB)

Check a company in the Swiss commercial register.

Results you can trust

Webhooks and signed results.

The webhook tells you something happened. The signed result tells you what, in a form anyone with our public keys can verify.

  1. 01

    Your backend

    POST /v1/sessions

  2. 02

    Hosted flow

    Document, liveness, face match

  3. 03

    Webhook

    secuveri-signature: HMAC-SHA256

  4. 04

    Signed result

    ES256 JWS, verified with /.well-known/jwks.json

  • Webhooks retried 7 times over about 21 hours
  • Event IDs to drop duplicates
  • No personal data in the signed result

Building blocks

What the API gives you.

Everything you need to run verification from your own backend.

Sessions API

Create a session and get a link and token. Idempotency keys, one open session per customer, and we can send the link by email or SMS.

Webhooks

Events when a verification finishes or is reviewed, HMAC-signed and retried for about 21 hours.

Signed results

Each result as an ES256 JWS without personal data, verifiable with our public keys.

Web embed

Open the flow in a modal or inline frame with one script tag, with a QR handoff to the phone.

Sandbox

Test keys and free scenarios that finish a session with the outcome you choose.

Re-authentication

Confirm a returning customer with a selfie and liveness, matched against their earlier verification.

Reusable ID in swiyu (beta)

After a full verification, people can save a secuveri Verified ID in the swiyu app and share it next time, bound to the holder. swiyu Beta-IDs are accepted too. Works on swiyu's public beta.

Block and allow lists

Block or allow emails, phone numbers, IP ranges, devices, your user IDs or document countries, by API or in the dashboard.

SDKs

Libraries and embeds.

Web embed script

Available

secuveri.js opens the hosted flow in a modal or inline frame and reports its progress.

REST API

Available

Plain HTTPS and JSON from any language, with an OpenAPI description.

@secuveri/web

Available

A typed browser package for the embed and its events.

@secuveri/node

Available

A Node.js client for sessions, results and webhook signature checks.

iOS SDK

Coming soon

Native capture and NFC chip reading inside your iPhone app.

Android SDK

Coming soon

Native capture and NFC chip reading inside your Android app.

Contact

Talk to us

Tell us what you’re trying to verify. We’ll show you how secuveri can fit your workflow.

We reply within one business day and use your details only for your inquiry. See our privacy policy.