v1.4 — Stabiel

Developer documentatie

Orevox aggregeert sanctielijsten, reisadviezen, politieke stabiliteit, corruptie en conflictdata uit elf databronnen in één JSON response per land.

🌍

195 landen

Volledige werelddekking

🔄

Elke 6 uur

Reisadviezen bijgewerkt

🛡️

11 databronnen

Sancties, reisadvies, media, conflicten

⚡

<100ms

Gemiddelde responstijd

Quick start

Stuur je eerste request in minder dan een minuut. Je API key staat in je portaal.

curl https://api.orevox.eu/api/v1/risk/IR \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "isoCode": "IR",
  "countryName": "Iran",
  "aggregatedRisk": 8.4,
  "travelAdvisoryScore": 9,
  "sanctionedEu": true,
  "sanctionedOfac": true,
  "stabilityScore": -1.80,
  "sources": {
    "buza":       "2026-03-18T06:00:00Z",
    "euSanctions": "2026-03-18T02:00:00Z",
    "ofac":       "2026-03-18T02:30:00Z",
    "worldBank":  "2026-03-01T03:00:00Z"
  }
}

Authenticatie

Alle API requests vereisen authenticatie via de X-Api-Key header. Je API key is te vinden in je portaal.

Let op: Sla je API key nooit op in client-side code of public repositories. Gebruik environment variables.

bash

curl https://api.orevox.eu/api/v1/risk/NL \
  -H "X-Api-Key: or_live_your-api-key"

Key formaat

Keys beginnen altijd met or_live_ gevolgd door een unieke hash. Keys zijn eenmalig zichtbaar bij aanmaken. Verloren keys kunnen worden gereset via het portaal.

Tiers & limieten

Calls worden per kalendermaand geteld. Bij het bereiken van je limiet geeft de API een 429 terug.

Tier	Prijs	Calls/maand	Batch	History	Sancties & CSDDD	PEP zoeken	Webhooks	Export
Free	€0/mo	100	✗	✗	✗	✗	✗	✗
Starter	€99/mo	500	✗	✗	✗	✗	✗	✗
Growth	€299/mo	5.000	✓	✓	✓	✓	✓	✗
Enterprise	€799/mo	Onbeperkt	✓	✓	✓	✓	✓	✓

Custom weights

Op risk-endpoints kun je de gewichten van de vier hoofdcomponenten aanpassen via query parameters. De gewichten hoeven niet op te tellen tot 100% — ze worden automatisch genormaliseerd.

Parameter	Default	Description
wTravel	0.40	Gewicht voor reisadvies (0.0–1.0)
wSanctions	0.35	Gewicht voor sancties (0.0–1.0)
wStability	0.25	Gewicht voor politieke stabiliteit (0.0–1.0)
wMedia	0.05	Gewicht voor mediasignaal (0.0–1.0, optioneel)

Voorbeeld: zwaar gewicht op sancties (financieel due diligence):

bash

curl "https://api.orevox.eu/api/v1/risk/RU?wTravel=0.10&wSanctions=0.70&wStability=0.20" \
  -H "X-Api-Key: or_live_your-api-key"

Custom weights zijn beschikbaar op: GET /risk, GET /risk/{iso}, POST /risk/batch en GET /risk/{iso}/score.

Endpoints

GET/api/v1/risk

Geeft risicoprofielen van alle landen, gesorteerd op risico (hoog naar laag). Optioneel te filteren via query parameters.

Optionele parameters: minScore, maxScore, sanctionedEu, sanctionedOfac, sanctionedUn, sanctionedUk, sanctionedCa, sanctionedAu, sort (risk_desc|risk_asc), sector

curl https://api.orevox.eu/api/v1/risk \
  -H "X-Api-Key: or_live_your-api-key"

GET/api/v1/risk/{isoCode}

Volledig risicoprofiel van één land. Accepteert ISO 3166-1 alpha-2 of alpha-3 codes. Optioneel: sector preset of custom weights.

curl https://api.orevox.eu/api/v1/risk/RU \
  -H "X-Api-Key: or_live_your-api-key"

GET/api/v1/risk/{isoCode}/score

Alleen de geaggregeerde score. Goedkoop endpoint voor polling of monitoring.

bash

curl https://api.orevox.eu/api/v1/risk/SY/score \
  -H "X-Api-Key: or_live_your-api-key"

# Response:
# { "isoCode": "SY", "score": 9.5 }

GET/api/v1/risk/{isoCode}/breakdown

Gedetailleerde uitsplitsing van de score per component — reisadvies, sancties, stabiliteit, media, corruptie, conflict — inclusief de gebruikte gewichten. Vereist Starter tier of hoger.

curl https://api.orevox.eu/api/v1/risk/RU/breakdown \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "isoCode": "RU",
  "aggregatedRisk": 9.1,
  "weightsUsed": { "travel": 0.40, "sanctions": 0.35, "stability": 0.25 },
  "components": {
    "travel":    { "raw": 9,    "contribution": 3.60 },
    "sanctions": { "base": 7.0, "contribution": 2.45 },
    "stability": { "raw": -1.2, "normalized": 7.42, "contribution": 3.08 }
  }
}

GET/api/v1/risk/{isoCode}/trendGrowth+

7-daagse trendanalyse: richting (omhoog/stabiel/omlaag), delta en historische context. Vereist Growth tier of hoger.

bash

curl https://api.orevox.eu/api/v1/risk/UA/trend \
  -H "X-Api-Key: or_live_your-api-key"

# Response:
# {
#   "isoCode": "UA",
#   "direction": "up",
#   "delta7d": 0.4,
#   "previous7d": 7.8,
#   "current": 8.2
# }

GET/api/v1/risk/{isoCode}/historyGrowth+

Risicoscores van de afgelopen 90 dagen. Vereist Growth tier of hoger.

curl https://api.orevox.eu/api/v1/risk/UA/history \
  -H "X-Api-Key: or_live_your-api-key"

GET/api/v1/risk/{isoCode}/csdddGrowth+

CSDDD-compliance rapport conform EU Richtlijn 2024/1760 (Corporate Sustainability Due Diligence). Bevat 6 indicatoren: mensenrechten, arbeid, sanctieblootstelling, reisadvies, corruptie en conflictrisico. Vereist Growth tier.

curl https://api.orevox.eu/api/v1/risk/CN/csddd \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "isoCode": "CN",
  "countryName": "China",
  "standard": "EU CSDDD 2024/1760",
  "reportDate": "2026-03-25",
  "overallRisk": "HIGH",
  "indicators": {
    "humanRightsRisk":    { "value": "HIGH",   "rationale": "EU + OFAC sanctions active" },
    "laborRisk":          { "value": "MEDIUM", "rationale": "PV.EST: -0.44" },
    "sanctionsExposure":  { "value": "FULL",   "rationale": "6/6 lists active" },
    "travelAdvisoryLevel":{ "value": "HIGH",   "rationale": "Level 3 advisory" },
    "corruptionRisk":     { "value": "HIGH",   "rationale": "CC.EST: -0.28" },
    "conflictRisk":       { "value": "LOW",    "rationale": "Signal: 0.3/10" }
  }
}

POST/api/v1/risk/batchGrowth+

Vraag tot 50 landen tegelijk op. Vereist Growth tier of hoger.

curl -X POST https://api.orevox.eu/api/v1/risk/batch \
  -H "X-Api-Key: or_live_your-api-key" \
  -H "Content-Type: application/json" \
  -d '["IR", "RU", "SY", "KP", "UA"]'

POST/api/v1/risk/portfolioGrowth+

Bereken een gewogen risicoscore voor een portefeuille van landen. Gewichten zijn optioneel en worden automatisch genormaliseerd. Vereist Growth tier.

curl -X POST https://api.orevox.eu/api/v1/risk/portfolio \
  -H "X-Api-Key: or_live_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"countries":[{"isoCode":"DE"},{"isoCode":"RU","weight":0.6},{"isoCode":"CN","weight":0.3}]}'

Response:

json

{
  "portfolioScore": 7.4,
  "countryCount": 3,
  "riskLevel": "HIGH",
  "countries": [
    { "isoCode": "DE", "countryName": "Germany", "score": 2.1, "weight": 0.10 },
    { "isoCode": "RU", "countryName": "Russia",  "score": 9.1, "weight": 0.60 },
    { "isoCode": "CN", "countryName": "China",   "score": 7.3, "weight": 0.30 }
  ]
}

GET/api/v1/risk/sectors

Geeft de beschikbare sector-presets terug met hun gewichten. Gebruik de sectornaam als ?sector= parameter op risico-endpoints.

bash

curl https://api.orevox.eu/api/v1/risk/sectors \
  -H "X-Api-Key: or_live_your-api-key"

# Apply a sector:
# GET /api/v1/risk/RU?sector=Finance

Response:

json

[
  { "sector": "Finance",    "wTravel": 0.20, "wSanctions": 0.55, "wStability": 0.25 },
  { "sector": "Mining",     "wTravel": 0.30, "wSanctions": 0.35, "wStability": 0.35 },
  { "sector": "Technology", "wTravel": 0.15, "wSanctions": 0.50, "wStability": 0.35 },
  ...
]

GET/api/v1/risk/{isoCode}/sanctionsGrowth+

Geeft een lijst van alle gesanctioneerde individuen, bedrijven en vaartuigen voor één land, afkomstig van EU FSF en/of OFAC SDN. Vereist Growth tier of hoger.

curl https://api.orevox.eu/api/v1/risk/RU/sanctions \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "isoCode": "RU",
  "total": 4658,
  "entities": [
    { "source": "OFAC", "name": "ALFA-BANK", "type": "entity", "programme": "RUSSIA-EO14024" },
    { "source": "EU",   "name": "Aleksandr Sergeevich KUZNETSOV", "type": "individual", "programme": "RUS" },
    ...
  ]
}

GET/api/v1/pep/searchGrowth+

Zoek op Politically Exposed Persons (PEP). Minimaal 2 tekens vereist. Optioneel te filteren op ISO-landcode. Vereist Growth tier.

curl "https://api.orevox.eu/api/v1/pep/search?q=Putin&country=RU" \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "query": "Putin",
  "country": "RU",
  "totalMatches": 3,
  "results": [
    {
      "id": 1,
      "name": "Vladimir Putin",
      "role": "President of Russia",
      "country": "RU",
      "countryName": "Russia",
      "source": "OpenSanctions"
    }
  ]
}

GET/api/v1/sanctions/searchGrowth+

Zoek in de gesanctioneerde entiteiten database (EU + OFAC). Minimaal 2 tekens. Optioneel filteren op sanctielijst. Vereist Growth tier.

curl "https://api.orevox.eu/api/v1/sanctions/search?q=Gazprom&source=OFAC" \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

{
  "query": "Gazprom",
  "source": "OFAC",
  "totalMatches": 2,
  "results": [
    {
      "name": "GAZPROMBANK",
      "type": "entity",
      "source": "OFAC",
      "isoCode": "RU",
      "countryName": "Russia",
      "programme": "RUSSIA-EO14024"
    }
  ]
}

GET/api/v1/portal/me

Account info: tier, calls deze maand, quota en reset datum.

bash

curl https://api.orevox.eu/api/v1/portal/me \
  -H "X-Api-Key: or_live_your-api-key"

# Response:
# {
#   "tier": "GROWTH",
#   "callsThisMonth": 1234,
#   "monthlyQuota": 5000,
#   "quotaResetAt": "2026-04-01T00:00:00Z"
# }

GET/api/v1/portal/usage

Gedetailleerde gebruiksstatistieken: huidige maand en dagelijks verbruik van de afgelopen 30 dagen.

bash

curl https://api.orevox.eu/api/v1/portal/usage \
  -H "X-Api-Key: or_live_your-api-key"

# Response:
# {
#   "currentMonth": { "calls": 1234, "quota": 5000, "remaining": 3766, "percentUsed": 25 },
#   "last30Days": [
#     { "date": "2026-03-24", "calls": 47 },
#     { "date": "2026-03-25", "calls": 23 }
#   ]
# }

GET/api/v1/portal/watchlistGrowth+

Beheer een watchlist van landen. Ontvang e-mailmeldingen wanneer de risicoscore een drempelwaarde overschrijdt. Vereist Growth tier.

# List watchlist
curl https://api.orevox.eu/api/v1/portal/watchlist \
  -H "X-Api-Key: or_live_your-api-key"

Response:

json

[
  {
    "isoCode": "RU",
    "countryName": "Russia",
    "threshold": 7.5,
    "emailAlert": true
  }
]

PUT/api/v1/portal/webhookGrowth+

Stel een webhook in voor risicoscore-wijzigingen groter dan 1.5 punt. Vereist Growth+.

bash

curl -X PUT https://api.orevox.eu/api/v1/portal/webhook \
  -H "X-Api-Key: or_live_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-app.com/riskpulse-webhook"}'

Webhook payload

json

{
  "event": "risk.score_changed",
  "isoCode": "IR",
  "countryName": "Iran",
  "previousScore": 7.1,
  "newScore": 9.0,
  "delta": 1.9,
  "timestamp": "2026-03-18T06:00:00Z"
}

Response schema

Alle risk endpoints retourneren een RiskProfile object.

Veld	Type	Omschrijving
isoCode	string	ISO 3166-1 alpha-2 landcode (bijv. "IR")
countryName	string	Volledige Engelstalige landnaam
aggregatedRisk	float	Gewogen risicoscore 1.0–10.0 (1 decimaal)
travelAdvisoryScore	integer	Gecombineerde reisadvies score: 1=veilig, 3=oplettend, 6=hoog risico, 9=niet reizen
sanctionedEu	boolean	Land staat op EU FSF sanctielijst
sanctionedOfac	boolean	Land staat op US OFAC SDN lijst
sanctionedUn	boolean	Land staat op VN Consolidated Sanctions lijst
sanctionedUk	boolean	Land staat op UK FCDO sanctielijst (UKSL)
sanctionedCa	boolean	Land staat op Canadese SEMA sanctielijst
sanctionedAu	boolean	Land staat op Australische DFAT sanctielijst
stabilityScore	float	Wereldbank PV.EST index: -2.5 (onstabiel) tot +2.5 (stabiel)
mediaSignal	float?	GDELT negatieve mediasignaal 0–2.5 (nullable, ingeschakeld via feature flag)
corruptionScore	float?	Wereldbank CC.EST index: -2.5 (corrupt) tot +2.5 (schoon) (nullable)
conflictSignal	float?	ACLED gewapend conflict signaal 0–10 (nullable, vereist API key)
sectorUsed	string?	Sector preset gebruikt voor berekening (nullable)
regionalWarning	string?	Kleurcode regionaal reisadvies (nullable)
regionalWarningArea	string?	Naam van het regio met verhoogd advies (nullable)
sources	object	Tijdstempels van de laatste data-update per bron (buza, euSanctions, ofac, worldBank, stateDept, un, uk, ca, au)

SanctionList schema

Het /sanctions endpoint retourneert een SanctionList object met daarin een lijst van entiteiten.

Veld	Type	Omschrijving
isoCode	string	ISO 3166-1 alpha-2 landcode
total	integer	Totaal aantal gevonden entiteiten
entities	array	Lijst van gesanctioneerde entiteiten
entities[].source	string	"EU" of "OFAC"
entities[].name	string	Naam van persoon, bedrijf of vaartuig
entities[].type	string?	Type entiteit: individual, entity, vessel, aircraft, group (nullable)
entities[].programme	string	Sanctieregime, bijv. "RUSSIA-EO14024" of "RUS"

Score berekening

De aggregatedRisk is een gewogen gemiddelde van drie databronnen, afgerond op één decimaal en begrensd tussen 1.0 en 10.0.

Uitleg per component

Reisadvies (BuZa + US + FCDO)40%

Gecombineerd reisadvies van drie bronnen: BuZa (Nederlands), US State Dept en UK FCDO. Wanneer alle drie beschikbaar zijn: BuZa 25% + US 50% + FCDO 25%. Als maar twee bronnen beschikbaar zijn gelden aangepaste verhoudingen.

Veilig → 1 · Oplettend → 3 · Hoog risico → 6 · Niet reizen → 9

Sancties (EU, OFAC, VN, UK, CA, AU)35%

Als een land op een van de zes sanctielijsten staat (EU FSF, OFAC SDN, VN, UK, Canada, Australië), geldt een sanctiebasis van 7,0. Niet-gesanctioneerde landen krijgen een basis van 1,0.

Niet gesanctioneerd → basis 1,0 · Gesanctioneerd → basis 7,0

Politieke stabiliteit (Wereldbank)25%

De Wereldbank PV.EST indicator meet politieke instabiliteit en geweld. Orevox normaliseert dit naar een schaal van 1–9 zodat een hogere waarde altijd meer risico betekent.

+2,5 (stabiel) → risicoscore 1 · −2,5 (onstabiel) → risicoscore 9

Formule

score = clamp(1.0, 10.0,

travelAdvisory × 0.40 +

sanctionBase × 0.35 +

stabilityNorm × 0.25

)

// Waar:

sanctionBase = 7.0 if sanctioned, else 1.0

stabilityNorm = ((-wb + 2.5) / 5.0) × 8.0 + 1.0

Risiconiveau	Score	Kleur
Kritiek	≥ 9.0	● Donkerrood
Hoog	7.0 – 8.9	● Rood
Midden	4.0 – 6.9	● Oranje
Laag	< 4.0	● Groen

Foutcodes

Status	Betekenis	Oplossing
401	Unauthorized	Ontbrekende of ongeldige X-Api-Key header	Controleer je API key in het portaal
403	Forbidden	Endpoint vereist hogere tier	Upgrade naar Growth of Enterprise
404	Not Found	Landcode niet gevonden	Gebruik een geldige ISO 3166-1 code
429	Too Many Requests	Maandquotum bereikt	Wacht op quotumreset of upgrade
502	Bad Gateway	Upstream fout bij ophalen data	Probeer opnieuw, wij monitoren dit

Databronnen

BuZa reisadvies

travelAdvisoryScore

Elke 6 uur

Nederlandse reisadviezen van het Ministerie van Buitenlandse Zaken. Kleurcodes: groen (1), geel (3), oranje (6), rood (9).

US State Dept travel advisory

travelAdvisoryScore

Elke 6 uur

Amerikaanse reisadviezen niveaus 1–4 (scores 2, 4, 7, 9). Combineert met BuZa voor het gecombineerde reisadvies.

UK FCDO travel advice

travelAdvisoryScore

Elke 6 uur

Britse FCDO reisadviezen. Derde reisbron die de gecombineerde score verfijnt.

EU FSF sanctielijst

sanctionedEu

Elke nacht 02:00

Europese Unie Financial Sanctions Files. Landen waarop EU-sancties van kracht zijn.

OFAC SDN lijst

sanctionedOfac

Elke nacht 02:30

US Treasury OFAC Specially Designated Nationals lijst. Landen waarop Amerikaanse sancties van kracht zijn.

VN Consolidated Sanctions

sanctionedUn

Elke nacht 01:30

VN-Veiligheidsraad geconsolideerde sanctielijst in XML-formaat.

UK Sanctions List (UKSL)

sanctionedUk

Elke nacht 01:45

UK FCDO sanctielijst, onafhankelijk van EU-sancties na Brexit.

Canada SEMA

sanctionedCa

Elke nacht 05:00

Canadese Special Economic Measures Act sanctielijst.

Australië DFAT

sanctionedAu

Elke nacht 05:30

Australische DFAT geconsolideerde sanctielijst (XLSX-formaat).

Wereldbank PV.EST

stabilityScore

1× per maand

Political Stability and Absence of Violence/Terrorism indicator. Bereik: -2.5 tot +2.5.

Wereldbank CC.EST (corruptie)

corruptionScore

1× per maand

Control of Corruption indicator. Bereik: -2.5 (hoog corrupt) tot +2.5 (laag corrupt). Optioneel scoringscomponent.

GDELT v2 media

mediaSignal

Elke nacht 04:15

Negatieve mediasignaal op basis van 7-daagse toonchart uit GDELT v2 DOC API. Bereik: 0–2.5.

ACLED conflictdata

conflictSignal

Elke 12 uur

Gewapend conflict signaal op basis van ACLED event- en slachtofferdata van de afgelopen 30 dagen. Bereik: 0–10.

Changelog

v1.4.0

Maart 2026

✓ Nieuw: FREE tier — gratis zelfregistratie via /signup (100 calls/maand)
✓ Nieuw: portfolio persistentie — landen en gewichten worden opgeslagen per account
✓ Nieuw: PEP zoeken in dashboard en via /pep/search API
✓ Nieuw: Sanctie-entiteiten zoeken via /sanctions/search API
✓ Nieuw: Watchlist — sla landen op met drempelwaarde voor e-mailmeldingen
✓ Nieuw: /risk/{isoCode}/breakdown endpoint met gewichtsdetails (Starter+)
✓ Nieuw: /risk/{isoCode}/trend endpoint met 7-daagse trendanalyse (Growth+)
✓ Nieuw: /portal/usage endpoint met dagelijks verbruik afgelopen 30 dagen
✓ Verbeterd: CSDDD rapport uitgebreid met conflictrisico indicator
✓ Verbeterd: Interactieve wereldkaart met conflictmarkeringen en regionale adviezen

v1.3.0

Maart 2026

✓ Nieuw: /risk/{isoCode}/csddd — CSDDD compliance rapport (EU Richtlijn 2024/1760) (Growth+)
✓ Nieuw: /risk/sectors — sector-specifieke gewichtsinstellingen (publiek)
✓ Optionele ?sector= parameter op /risk, /risk/{iso}, /risk/batch en /risk/{iso}/score
✓ UK FCDO reisadvies als derde reisbron (travel_score_fcdo)
✓ ACLED conflict signaal (every 12h, vereist API key)
✓ Wereldbank corruptie score (CC.EST, maandelijks)
✓ GDELT schedule gewijzigd naar 04:15 UTC nightly (was elke 6 uur)
✓ Zelf API key roteren via /portal/rotate-key
✓ Webhook retry logica (3× met 2s backoff)
✓ Scheduler pool vergroot naar 4 threads

v1.1.0

Maart 2026

✓ Nieuw: /sanctions endpoint — lijst van gesanctioneerde personen/bedrijven per land (Growth+)
✓ ~19.000 entiteiten geladen uit EU FSF en OFAC SDN lijsten
✓ Regionaal reisadvies veld toegevoegd (regionalWarning, regionalWarningArea)
✓ Score-uitleg en legenda toegevoegd in de dashboard modal
✓ Interactieve filterchips en sorteerbare kolommen in de landentabel

v1.0.0

Maart 2026

✓ Initiële release
✓ Risk profile endpoint voor 195 landen
✓ Batch endpoint (Growth+)
✓ History endpoint met 90 dagen data (Growth+)
✓ Webhook notificaties bij score-wijzigingen (Growth+)
✓ Vier databronnen: BuZa, EU FSF, OFAC SDN, Wereldbank

Vragen of problemen? Mail naar support@orevox.eu

Download OpenAPI spec