Internal APIs

Face Match

Match a face embedding against enrolled attendees in an organization.

POST/api/match-face

Accepts a 128-dimensional face embedding vector and matches it against enrolled attendees using cosine distance. Returns the closest match if within the distance threshold. This is an internal API used by the Attend-Go kiosk and session interface.

Authorization

Session Authentication

This is an internal API that requires an active browser session. It cannot be called with an API key.

Body Parameters

Parameter	Type	Required	Description
`org_id`	string (UUID)	required	Organization UUID to search within.
`embedding`	number[]	required	128-dimensional face embedding vector from face-api.js.
`max_distance`	number	Default: 0.5	Maximum cosine distance threshold for a match. Clamped to [0.2, 0.85].

Responses

Match found or no match.

{
  "match": {
    "attendee_id": "uuid-here",
    "distance": 0.32
  }
}