API Documentation

Real-time risk intelligence via REST API. Base URL: https://riskvector.app

Authentication

Include your API key in the header:

Authorization: Bearer YOUR_API_KEY

Get an API key on our pricing page.

GET/api/risk/{country}

Get comprehensive risk assessment for a country.

Parameters

countrystring— Country name (URL-encoded)

Response Example

{"country":"Germany","overall":25,"political":30,"health":15,"weather":20,"infrastructure":18}

GET/api/alerts

Get latest global alerts from GDACS, USGS, NOAA.

Response Example

{"alerts":[{"id":"...","type":"high","title":"M6.2 - Turkey"}]}

POST/api/simulate

Run a risk simulation scenario.

Parameters

questionstring— Scenario description (min 5 chars)

Response Example

{"success":true,"report":{"overallRisk":75,"riskLevel":"HIGH"}}

GET/api/risk/{country}/historical

Get historical risk score data.

Parameters

countrystring— Country name

Response Example

{"country":"Iran","history":[{"date":"2026-04-01","overall":92}]}

Free tier: 60 requests/hour. Pro: Unlimited.