Currency updated.

Isarud API-documentatie

API voor sanctiescreening en risicoanalyse.

Multi-Platform Access

Access your screening data and trade compliance tools from any device.

Authenticatie

Alle API-verzoeken vereisen een Bearer-token. Genereer uw API-sleutel vanaf het Dashboard (Business-plan vereist).

Authorization: Bearer YOUR_API_KEY

Create a free account to get your API key →

Basis-URL

https://isarud.com/api/v1

All requests must use HTTPS. Responses are JSON.

Eindpunten

POST /v1/screen

Screen een enkele naam tegen alle sanctielijsten.

Request

{
  "name": "Ali Khamenei",
  "type": "individual"
}

Response

{
  "success": true,
  "data": {
    "query": "Ali Khamenei",
    "total_matches": 3,
    "results": [
      {
        "name": "Ali Hosseini KHAMENEI",
        "list": "OFAC SDN",
        "score": 95,
        "type": "individual",
        "country": "IR"
      }
    ]
  }
}
Parameters: name (required) — Entity name to screen. type (optional) — individual or entity.
GET /v1/screen/{id}

Retrieve details of a previous screening by ID.

POST /v1/screen/batch

Batch-screen tot 500 namen. JSON-array of CSV.

Request

{
  "names": ["Name One", "Name Two", "Name Three"]
}

Response

{
  "success": true,
  "data": {
    "total": 3,
    "results": [
      {"name": "Name One", "matches": 0},
      {"name": "Name Two", "matches": 2},
      {"name": "Name Three", "matches": 0}
    ]
  }
}
GET /v1/briefs

Krijg de laatste risicointelligentiebrieven.

GET /v1/briefs/{id}

Retrieve a specific OSINT risk brief by ID.

GET /v1/lists

Krijg metagegevens en laatste update van sanctielijsten.

Response

{
  "success": true,
  "data": [
    {"code": "ofac_sdn", "name": "OFAC SDN", "count": 12450},
    {"code": "eu", "name": "EU Consolidated", "count": 8200},
    {"code": "un", "name": "UN Security Council", "count": 1850},
    {"code": "uk_hmt", "name": "UK HMT", "count": 4100},
    {"code": "ca_sema", "name": "Canada SEMA", "count": 2300},
    {"code": "au_dfat", "name": "Australia DFAT", "count": 1100},
    {"code": "world_bank", "name": "World Bank", "count": 950},
    {"code": "ofac_cons", "name": "OFAC Consolidated", "count": 1602}
  ]
}
GET /v1/lists/{list}/updates

Get recent updates for a specific sanctions list (e.g. ofac_sdn, eu).

GET /v1/favorites

Sla een naam op voor automatisch opnieuw screenen.

POST /v1/favorites

Add an entity to your favorites watchlist.

DELETE /v1/favorites/{id}

Remove an entity from your favorites.

GET /v1/alerts

Retrieve your screening alerts and notifications.

GET /v1/webhooks

List your configured webhooks.

POST /v1/webhooks

Registreer webhook voor real-time meldingen.

Request

{
  "url": "https://yoursite.com/webhook",
  "events": ["screening.match", "list.updated"]
}
PATCH /v1/webhooks/{id}

Update a webhook configuration.

DELETE /v1/webhooks/{id}

Delete a webhook.

POST /v1/webhooks/{id}/test

Send a test event to your webhook endpoint.

Error Codes

Code Status Description
200OKRequest successful
201CreatedResource created successfully
400Bad RequestInvalid parameters or missing required fields
401UnauthorizedMissing or invalid API key
403ForbiddenInsufficient plan or credits exhausted
404Not FoundResource not found
422UnprocessableValidation error
429Too Many RequestsRate limit exceeded

Error responses include a JSON body: {"success": false, "message": "Error description"}

Tarieflimieten

Plan Requests Screenings
Free10 req/min10/month
Pro ($29/mo)100 req/min100/month
Business ($99/mo)1,000 req/minUnlimited

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Sanctions Lists Coverage

32,500+ entities across 8 global sanctions lists:

OFAC SDN

OFAC Consolidated

EU Consolidated

UN Security Council

UK HMT

Canada SEMA

Australia DFAT

World Bank

Snelstartgids

cURL

curl -X POST https://isarud.com/api/v1/screen \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ali Khamenei", "type": "individual"}'

Python

import requests

r = requests.post("https://isarud.com/api/v1/screen",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"name": "Ali Khamenei", "type": "individual"})

print(r.json())

Node.js

const res = await fetch("https://isarud.com/api/v1/screen", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ name: "Ali Khamenei", type: "individual" })
});

console.log(await res.json());

PHP (Laravel)

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_API_KEY',
])->post('https://isarud.com/api/v1/screen', [
    'name' => 'Ali Khamenei',
    'type' => 'individual',
]);

return $response->json();

Klaar om te integreren?

Krijg uw API-sleutel en begin binnen minuten met screenen.

Aan de slag