Authentication
Create keys in the dashboard under Integrations. A key is shown once; store it in your secret manager.
Authorization: Bearer evd_live_…
Test keys (evd_test_) work on your real data but cannot publish or withdraw passports.
Scopes
Give each key only the scopes it needs. A request outside the key's scopes gets a 403.
| Scope | Description |
|---|---|
products.read | Read products, serials and lots, and compliance records. |
products.write | Create and change products, serials and lots, and compliance records. |
documents.read | Read documents and their extraction results. |
documents.write | Upload documents. |
passports.read | Read passports. |
passports.publish | Publish and withdraw passports. Test keys cannot do this. |
webhooks.manage | List webhook endpoints, change their events, and replay deliveries. |
api_keys.manage | List and revoke API keys. |