Skip to main content
POST
/
v1
/
lists
/
{uuid}
/
entries
/
face
Upload Face
curl --request POST \
  --url https://identity.contra.id/v1/lists/{uuid}/entries/face
Face uploads are a separate endpoint because the request includes binary data and the storage path is biometric-template-hashed.

​
Request

curl -X POST https://identity.contra.id/v1/lists/$UUID/entries/face \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "image":     "data:image/jpeg;base64,/9j/4AAQ…",
    "reason":    "duplicate account fraud",
    "session_id":"sess_b3f1c2a4"
  }'

​
Response · 201

{
  "uuid":             "ent_face_a1b2…",
  "fingerprint":      "sha256:abc123…",
  "raw_image_stored": false,
  "added_at":         1748566800
}
Contra stores only the irreversible biometric template hash, never the raw image. Matching is via cosine similarity against the template; the original photo cannot be reconstructed.