External IDs

Tie verifications to your own user identifiers.

Optionally tie a verification to your own user identifier by passing external_id. This lets you look up status later by your own ID instead of storing ours.

Node.js

const response = await fetch("https://api.connect.verifyyou.com/v2/verification/create", {
  method: "POST",
  headers: {
    "API-KEY": process.env.VERIFYYOU_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    redirect: "https://yourapp.com/verified",
    external_id: "user_8f3a29c1",
  }),
});

const data = await response.json();

Once set, you can check status by your own ID instead of the token:

Node.js

const response = await fetch("https://api.connect.verifyyou.com/v2/verification/status", {
  method: "POST",
  headers: {
    "API-KEY": process.env.VERIFYYOU_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ external_id: "user_8f3a29c1" }),
});

const data = await response.json();
if (data.verification_complete) {
  console.log("User is verified!");
}

Response

{
  "verification_complete": true,
  "external_id": "user_8f3a29c1"
}

If you pass both external_id and region, the person is still limited to one account per region — but can connect to new regions instantly without redoing the liveness check.