Skip to content

Trust Center

Verify your own users: ID documents, face match and company checks.

Open Trust Center
Checked against the dashboard on November 18, 2026

Three methods do from code what the Verify someone window does: open a session, read a session, and list sessions. Each one acts on the Trust Center of the account whose API key you use.

Open a session

Call verify_session_create. Send level (1 to 4, default 2) and, if you want, your own external_ref (200 characters at most). The answer carries a session_id, a hosted_url to send the person, and expires_at, which is 24 hours on.

Redirect your user to hosted_url, or send it to them.

Read the result

Call verify_session_result with the session_id. It returns the status, your external_ref, the times, and the result once the session is complete.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

What decides the session

  • The mode. A session is a test when the service runs in Test mode, and live when it runs in Live. Test sessions are free and never counted, and can be finished from the dashboard. Live links cannot be completed yet.
  • The level. A level above what your plan allows is refused, saying which plan carries it. The request is never quietly lowered.
  • Over the allowance. A live session past your plan's monthly allowance is refused on Free, and on a paid plan it is made and marked as an overage.

Keys are made in Developers, and making one needs your own Level 2.

Refusals

Webhooks

On Starter and up, set an address in Trust Center settings and a signed request is sent when a verification is decided, so you do not have to poll. Each carries an Xuda-Event header and an Xuda-Signature header made of a timestamp and an HMAC of the timestamp and the body, signed with the secret shown once in settings. A delivery that fails is tried again, up to five attempts.

How is this guide?

Last updated on November 12, 2026