> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontra.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Face Match

> Compare two faces and return a similarity score 0–100.

## Request

```bash theme={null}
curl -X POST https://identity.contra.id/v1/face-match \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "image_a": "data:image/jpeg;base64,/9j/4AAQ…",
    "image_b": "data:image/jpeg;base64,/9j/4AAQ…"
  }'
```

## Response · 200

```json theme={null}
{
  "match_id": "match_aafb…",
  "score":    97.3,
  "decision": "match",
  "threshold": 70
}
```

Combine with [ID Verification](/api-reference/identity/id-verification) for selfie-to-document binding.