FaceCard

Developer documentation

FaceCard adds face sign-in to your app. A browser SDK captures a face embedding, the API matches it inside your app only, and your server verifies a signed user token.

Get startedAPI reference
npm install @facecard/sdk
Introduction

What FaceCard is, what it stores (embeddings only, never images) and how sign-in works.

Quickstart: browser

Enroll and sign in a user from a script tag or a React app.

Quickstart: server

Verify user tokens and list users from Node with your secret key.

Concepts

Apps, keys, user tokens, challenges, matching and the limits of liveness.

API reference

Every v1 route with request, response, errors and curl examples.

Security and privacy

What is stored, the retention schedule, consent and deletion.

Embeddings only

The browser turns a face into 128 numbers. No face image is uploaded or stored.

Runs in the browser

No native SDK. Any device with a camera and a modern browser works.

Scoped keys

Publishable keys are limited to your allowed origins. Secret keys stay on your server.

facecard.dev · developers.facecard.dev · llms.txt · Built by EVERJUST