Recognise a person you already claimed
POST /identity/recognitions · Identity · version 2026-09-14
Confirms the live person in front of the camera is the holder of a FaceToken you already hold.
Free, at any volume, for life — in your product or in anyone else's on the network.
Both outcomes are a successful call. recognised: false means the reading did not match the token, not that the request failed.
Base URL
https://api.sidaxis.com/v1 in production, https://sandbox.api.sidaxis.com/v1 in sandbox.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| Authorization | header | string | required | Bearer sk_live_… in production, sk_test_… in sandbox. |
| Sidaxis-Version | header | string | optional | Dated version. Pin it in production. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| proof | string | required | Proof for this request. A proof issued for a sign-in cannot be replayed to approve a payment. |
| facetoken | string | required | The durable handle returned when you claimed the person. |
Example request
{
"proof": "zkp_01J8Y3Q2VXK7",
"facetoken": "0xA1f3c9b27d04"
}Responses
200 — Answered
Recognised, or not. Never billed either way.
{
"recognised": true,
"facetoken": "0xA1f3c9b27d04",
"receipt": {
"id": "rcpt_3d77a1e0",
"anchor": "0x51bb02c7d9af",
"url": "https://verify.sidaxis.com/r/3d77a1e0"
}
}Errors
liveness_required, rate_limited. See errors and refusals.
Notes
No idempotency key: the call holds no state and consumes no ceiling.
A FaceToken is derived from the person's coordinate and your public identifier together. It is stable for you forever and meaningless to anyone else, and it carries no biometric.