Up and running in three steps.
From zero to a verified skill response in under 10 minutes.
GET /v1/keys → Create a scoped key
Get API key
Open the developer dashboard. Navigate to Keys. Create a key with the scopes you need: read, assess, or verify. Keys are scoped per capability.
POST /v1/assess/invite
Send invite
Pass your key as a Bearer token. Send an assessment invite to a candidate with a specific skill and expiry time. You'll get an inviteId back.
GET /v1/verify/passport/:userId
Read results
Once the assessment is complete, retrieve the full verified skill passport in JSON. Typical response time under 200ms.
Everything in the reference.
Explore each API surface, understand rate limits, and find the error codes your integration needs to handle.
Assessments API
Send skill assessment invites to candidates, track completion, and retrieve structured results — all via a single REST endpoint.
Verify API
Query full skill passports, verify individual skills, or run batch verifications across a list of user IDs in one request.
Webhooks
Subscribe to real-time events — invite accepted, assessment completed, passport updated — and react instantly in your system.
SDKs
Official client libraries for JavaScript/TypeScript and Python. Type-safe, tree-shakeable, and maintained by the Lemma team.
Rate limits
Default rate limits per key tier, burst allowances, and guidance for requesting higher throughput for production workloads.
Error reference
Every API error has a stable machine code (e.g. INVITE_NOT_FOUND) with a documented cause, resolution, and retry guidance.
How the API works.
Simple, predictable, observable.
Authenticate with a scoped key
Every request uses a Bearer token. Keys are scoped to specific capabilities — read, assess, or verify. Create them from the dashboard with no credit card required during beta.
Call the endpoint you need
REST API with JSON request/response. Predictable error codes. No GraphQL, no custom query language. Just HTTP.
Subscribe to events
Register a webhook endpoint. Lemma will POST signed payloads to your URL whenever a relevant event fires — assessment completed, skill tier changed, passport updated.
Start building.
API keys are free during beta. No credit card required.