RiskVector API

Build travel risk intelligence into your product. RESTful API with real-time data for 195 countries.

Quick Start

Get started in 30 seconds. No signup required for testing.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://riskvector.app/api/risk/DE

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get your API key from the Dashboard. Free tier includes 100 requests/day.

Endpoints

GET/api/risk/{country}

Get country risk profile with 6-dimension scores

Parameters: country (ISO 3166-1 alpha-2 code, e.g., DE, US, JP)

Response Example
{
  "country": { "code": "DE", "name": "Germany", "flag": "🇩🇪" },
  "riskScore": {
    "overall": 72, "level": "low",
    "dimensions": [
      { "name": "Political Stability", "score": 85 },
      { "name": "Crime", "score": 78 },
      ...
    ]
  },
  "emergencyNumbers": { "police": "110", "ambulance": "112" }
}
GET/api/alerts

Get real-time global alerts (earthquakes, volcanoes, conflicts)

Parameters: None (returns all active alerts)

Response Example
{
  "alerts": [
    {
      "id": "eq-123",
      "severity": "high",
      "title": "M6.2 Earthquake - Turkey",
      "country": "Turkey",
      "source": "USGS"
    }
  ],
  "count": 50,
  "sources": ["USGS", "GDACS", "NOAA"]
}
GET/api/news/{country}

Get country-specific news and events

Parameters: country (ISO code)

Response Example
{
  "articles": [
    { "title": "...", "source": "...", "date": "..." }
  ]
}
POST/api/stripe/checkout

Create a Stripe checkout session for subscription

Parameters: tier: "pro" | "enterprise"

Response Example
{
  "url": "https://checkout.stripe.com/..."
}

Rate Limits

Free100 requests/day
Pro10,000 requests/day
EnterpriseUnlimited

Rate limit info is included in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

API Pricing

Free

€0

100 req/day

  • Risk scores
  • Basic alerts
  • Country data
Get started →
MOST POPULAR

Pro

€9.99/mo

10K req/day

  • All endpoints
  • Real-time alerts
  • Historical data
Get started →

Enterprise

€499+/mo

Unlimited

  • Custom SLA
  • Webhooks
  • Dedicated support
Get started →

SDKs & Libraries

🟨

JavaScript

npm install @riskvector/sdk
🐍

Python

pip install riskvector
🔄

cURL

No install needed