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 Stripe Checkout Session for subscription upgrade

Parameters: { tier: "pro" | "business", email?: string }

Response Example

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

Rate Limits

Alle NutzerUnlimited requests/day

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

API Access

€0

100% Kostenlos — alle Endpunkte, unlimited requests

✓All endpoints
✓Real-time alerts
✓Historical data
✓Webhooks

Get started →

SDKs & Libraries

🟨

JavaScript

npm install @riskvector/sdk

🐍

Python

pip install riskvector

🔄

cURL

No install needed