Documentazione API Isarud

API per screening sanzioni e intelligence dei rischi.

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

Prossimamente

Autenticazione

Tutte le richieste API richiedono un token Bearer. Genera la tua chiave API dalla Dashboard (piano Business richiesto).

Authorization: Bearer YOUR_API_KEY

Create a free account to get your API key →

URL di base

https://isarud.com/api/v1

All requests must use HTTPS. Responses are JSON.

Endpoint

POST /v1/screen

Esegui lo screening di un singolo nome rispetto a tutti gli elenchi di sanzioni.

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

Screening batch di fino a 500 nomi. Array JSON o 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

Ottieni gli ultimi brief di intelligence sui rischi.

GET /v1/briefs/{id}

Retrieve a specific OSINT risk brief by ID.

GET /v1/lists

Ottieni metadati degli elenchi di sanzioni e ultimo aggiornamento.

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

Salva un nome per lo screening automatico ricorrente.

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

Registra webhook per notifiche in tempo reale.

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

Limiti di velocità

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

Guida Rapida

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.

Pronto per integrare?

Ottieni la tua chiave API e inizia lo screening in pochi minuti.

Inizia