Skip to main content
POST
Adverse Media
Starts an asynchronous adverse-media check across news, court records, and watchlist databases. Because the scan fans out across multiple vendors, the request returns immediately with 202 Accepted and a jobId — poll GET /v1/async-jobs/{jobId} to retrieve the result once it’s ready.
This endpoint returns a job reference, not the screening result. The result is delivered through the async-jobs polling endpoint.

Request

Headers

Body parameters

Example request

Idempotency

Supply an optional Idempotency-Key header to make retries safe. The first request with a given key queues the job and returns 202. Any subsequent request with the same key returns 200 with the existing job reference instead of starting a duplicate scan. Use a unique key (e.g. a UUID) per logical screening request.

Response

202 — Accepted (new job queued)

200 — Existing job returned (reused Idempotency-Key)

Both responses share the same body shape:

Error responses

Result shape

Once the job reaches ready, the async-jobs endpoint returns the screening result in its result field: Each entry in findings has the following shape: