Documentação da API Isarud

API de triagem de sanções e inteligência de risco.

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

Em Breve

Autenticação

Todas as solicitações de API requerem um token Bearer. Gere sua chave de API no Dashboard (plano Business obrigatório).

Authorization: Bearer YOUR_API_KEY

Create a free account to get your API key →

URL Base

https://isarud.com/api/v1

All requests must use HTTPS. Responses are JSON.

Endpoints

POST /v1/screen

Triage um único nome em todas as listas de sanções.

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

Triagem em lote de até 500 nomes. Array JSON ou 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

Obtenha os últimos briefings de inteligência de risco.

GET /v1/briefs/{id}

Retrieve a specific OSINT risk brief by ID.

GET /v1/lists

Obtenha metadados das listas de sanções e última atualização.

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

Salve um nome para triagem automática recorrente.

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

Registre webhook para notificações em tempo real.

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

Limites de Taxa

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

Início Rápido

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 para integrar?

Obtenha sua chave de API e comece a fazer triagens em minutos.

Começar