Isarud API Documentation

Sanctions screening and risk intelligence API.

Multi-Platform Access

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

📱

iOS / macOS

App Store ↗

 🖥️

Windows

Microsoft Store ↗

 🔌

WooCommerce

WordPress.org ↗
🤖

Android

Coming Soon

Authentication

All API requests require a Bearer token. Generate your API key from the Dashboard (Business plan required).

Authorization: Bearer YOUR_API_KEY

Create a free account to get your API key →

Base URL

https://isarud.com/api/v1

All requests must use HTTPS. Responses are JSON.

Endpoints

POST /v1/screen

Screen a single name against all sanctions lists.

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 up to 500 names. JSON array or 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

Get the latest risk intelligence briefs.

GET /v1/briefs/{id}

Retrieve a specific OSINT risk brief by ID.

GET /v1/lists

Get sanctions lists metadata and last update.

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

Save a name for automatic re-screening.

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

Register webhook for real-time notifications.

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

Rate Limits

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

Quick Start

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

WooCommerce & Shopify Integration

No API coding required — use our plugins for automatic order screening and marketplace sync.

🔌 WooCommerce Plugin

Auto-screen orders, marketplace sync (Trendyol, Hepsiburada, N11, Amazon, Pazarama, Etsy), cloud sync.

🛍️ Shopify App

One-click install from Shopify App Store. Automatic checkout screening and order tagging.

Ready to integrate?

Get your API key and start screening in minutes.

Get Started