Developer API

Screen any company from your own code. Submit a name and country; get back structured risk intelligence — identity, ownership, sanctions, people, adverse media and more — as JSON, every finding cited.

Authentication

Create a key on your API keys page. Send it as a bearer token on every request. Keep it secret — it screens on your account.

Authorization: Bearer clr_live_xxxxxxxxxxxxxxxxxxxxxxxx

Base URL

https://amiligence.co/api/v1

Start a screening

POST /api/v1/screenings — country is an ISO-2 code. mode is "fast" (instant essentials) or "full" (everything, default).

curl -X POST https://amiligence.co/api/v1/screenings \
  -H "Authorization: Bearer $CLARENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "company": "Stripe", "country": "US", "mode": "full" }'

{
  "id": "6f1c2a7e-...",
  "status": "pending",
  "company": "Stripe",
  "country": "US",
  "mode": "full",
  "result_url": "https://amiligence.co/api/v1/screenings/6f1c2a7e-..."
}

Get the result

GET /api/v1/screenings/{id} — poll until status is "completed" (a full screen typically takes a few minutes; fast is seconds).

curl https://amiligence.co/api/v1/screenings/6f1c2a7e-... \
  -H "Authorization: Bearer $CLARENT_KEY"

{
  "id": "6f1c2a7e-...",
  "company": "Stripe",
  "country": "United States",
  "status": "completed",
  "overall_flag": "green",
  "risk_level": "Low",
  "summary": "No sanctions or debarment matches; ...",
  "counts": {
    "sanctions_hits": 0,
    "directors": 7,
    "adverse_media": 1,
    "government_contracts": 0
  },
  "report": { "...": "full structured report" }
}

List your screenings

curl https://amiligence.co/api/v1/screenings \
  -H "Authorization: Bearer $CLARENT_KEY"

Limits & errors

• Each key is capped at 100 screenings per day while in preview.
• Errors return a JSON body { "error": { "status", "message" } } with the matching HTTP status.
• 401 missing/invalid key · 400 bad input · 429 daily limit · 404 unknown screening.