Endpoints
API endpoints
These endpoints cover the main screening workflows. All use the same authentication and return the same Trust Layer fields.
Core API endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/screen | Screen a person or entitySingle-request sanctions and PEP screening with confidence, risk level, aliases, source attribution, and request ID. |
| POST | /v1/screen/entity | Entity + UBO screeningCorporate sanctions screening plus ownership-chain context where GLEIF data is available. |
| POST | /v1/screen/batch | Batch screeningSubmit multiple names in one request. Plan-gated batch size limits. |
| GET | /v1/entities/search | Canonical entity searchSearch the normalized entity graph for transliterations, variants, and canonical IDs. |
| GET | /v1/evidence-capsules/{id} | Retrieve Evidence CapsuleGet the full audit snapshot for a screening decision by its capsule ID. |
| GET | /v1/health | Health checkPublic health endpoint for service status and connectivity. |
| POST | /v1/adverse-media/screen | Adverse media screeningScreen individuals and companies against real-time news. GDELT fetch + Claude classification into 7 risk categories. Plan-gated. |
Conventions
All endpoints share the base URL https://api.verifex.dev and use the same Bearer-token authentication.
Every endpoint except /v1/health requires a Bearer token in the Authorization header.
Every screening endpoint returns the same Trust Layer fields, so a caller reads one decision contract across the API.