Isarud API-Dokumentation

Sanctions screening und Risk Intelligence API.

Multi-Platform Access

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

Authentifizierung

Alle API-Anfragen erfordern ein Bearer-Token. Generieren Sie Ihren API-Schlüssel im Dashboard (Business-Plan erforderlich).

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.

Endpunkte

POST /v1/screen

Überprüfen Sie einen einzelnen Namen gegen alle Sanktionslisten.

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-Überprüfung von bis zu 500 Namen. JSON Array oder 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

Erhalten Sie die neuesten Risk Intelligence Briefs.

GET /v1/briefs/{id}

Retrieve a specific OSINT risk brief by ID.

GET /v1/lists

Rufen Sie Metadaten der Sanktionslisten und das letzte Update ab.

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

Speichern Sie einen Namen für automatische Neuüberprüfung.

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

Registrieren Sie einen Webhook für Echtzeit-Benachrichtigungen.

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"}

Ratenbegrenzungen

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

Schnelleinstieg

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();

Bereit zur Integration?

Holen Sie sich Ihren API-Schlüssel und beginnen Sie in wenigen Minuten mit der Überprüfung.

Erste Schritte