Developer hub lemma.id

lemma.id proof of humanity

Integrate verified-human credentials into your app with site-private PPIDs and local browser verification. No webhooks to configure on your side — embed the SDK, set siteId to your hostname, and register a site API key only when you need server-side blocks or network revocation requests.

Read the guide 5-minute quickstart SDK script URL

1) Integrate

Embed the verifier SDK and gate actions with verify({ autoProvision: true }). No dashboard step required for the basic human check.

  • Set siteId to your canonical hostname (for example app.example.com).
  • Add ishuman-verifier.js and fail closed when human is false.
  • Store the returned ppid on your user record — no KYC fields.
5-minute quickstart SDK integration

2) Operate

The SDK handles IDV and site-proof derivation in a Lemma-hosted popup. Your server does not receive webhooks for verification completion.

  • First visit may open a popup (wallet unlock + Didit IDV).
  • Later checks validate locally — no per-page network call.
  • Optional: stamp actions and re-verify on your backend with verifyStamp().
Integration flow API reference

3) Enforce bans

Use your site API key for server-side abuse response. The API key is not required for human verification itself.

  • POST /api/ishuman/site-block — immediate site-scoped PPID ban.
  • POST /api/ishuman/network-revoke — request network-wide action.
  • Issue keys in the API key manager.
Open API key manager

Full documentation: /docs. Legacy IAM-only consoles remain on restricted admin routes.