Travel Risk
Intelligence API

List all countries with advisory level and composite risk score. risk_score is the same composite returned by /risk-score/{iso}; base_risk_score is the advisory level alone and active_alerts shows how many alerts contributed.

Parameters: skip (default 0), limit (default 50, max 1000)

{
  "total": 229,
  "skip": 0,
  "limit": 2,
  "data": [
    {
      "iso_code": "AFG",
      "name": "Afghanistan",
      "advisory_level": 4,
      "risk_score": 5.0,
      "base_risk_score": 4.0,
      "active_alerts": 2,
      "last_updated": "2026-08-11T17:50:49"
    }
  ]
}

Every supported country code in a single response, no pagination. Use it to validate input on your side.

{
  "total": 229,
  "note": "Codes are ISO 3166-1 alpha-3 (3 letters), e.g. USA, GBR, FRA.",
  "codes": ["ABW", "AFG", "AGO", "AIA", "ALB", "..."],
  "countries": [{"iso_code": "ABW", "name": "Aruba"}]
}

Detail for one country, including the advisory description.

Accepts: alpha-3 (USA) or alpha-2 (US).

{
  "iso_code": "USA",
  "name": "United States",
  "advisory_level": 1,
  "advisory_description": null,
  "risk_score": 1.0,
  "last_updated": "2026-08-11T17:50:49"
}

Active disaster and hazard alerts — earthquakes, floods, cyclones, wildfires, storms, humanitarian events.

Parameters: severity (Low | Medium | High | Critical), alert_type (earthquake | flood | wildfire | cyclone | volcano | drought | severe_storm | humanitarian | armed_conflict | other), country_iso, days (last N days, 1–365), updated_since (ISO-8601 — only alerts created or revised since then), updated_since (ISO-8601 — only alerts created or revised since then), skip, limit (max 1000)

Change tracking: an alert keeps the same id when an upstream revises it — we update the record and bump updated_at. Poll ?updated_since= to sync incrementally instead of re-reading the whole feed.

{
  "total": 19141,
  "skip": 0,
  "limit": 1,
  "filters": {"severity": null, "alert_type": null, "country_iso": null, "days": 7},
  "data_updated_at": "2026-08-11T17:57:38",
  "generated_at": "2026-08-11T18:02:11+00:00",
  "data": [
    {
      "id": 62451,
      "alert_type": "earthquake",
      "severity": "Medium",
      "country_iso": "JPN",
      "location": "near the east coast of Honshu, Japan",
      "latitude": 37.12,
      "longitude": 141.35,
      "description": "M 4.8 - near the east coast of Honshu, Japan",
      "event_date": "2026-08-11T15:22:04",
      "created_at": "2026-08-11T15:45:01",
      "updated_at": "2026-08-26T15:42:13",
      "source": "seismic",
      "external_id": "a1b2c3d4e5f6",
      "polygon": null
    }
  ]
}

A single alert by its numeric id.

Armed-conflict and unrest events with location, severity and mention counts. Refreshed every 15 minutes; a rolling 30-day window is retained.

Parameters: country_iso, severity, skip, limit (max 1000)

{
  "total": 41033,
  "skip": 0,
  "limit": 1,
  "data": [
    {
      "id": 210102,
      "country_iso": "SDN",
      "location": "Khartoum, Sudan",
      "latitude": 15.55,
      "longitude": 32.53,
      "severity": "High",
      "event_date": "2026-08-10T00:00:00",
      "num_mentions": 47,
      "description": "Armed clash reported"
    }
  ]
}

Government travel advisories grouped by country, with the maximum level across sources. Three independent government sources, refreshed daily.

Parameters: country_iso, min_level, skip, limit (max 1000)

{
  "total": 225,
  "data": [
    {
      "iso_code": "AFG",
      "name": "Afghanistan",
      "max_level": 4,
      "sources": [
        {
          "agency": "agency-1",
          "level": 4,
          "summary_label": "Do Not Travel",
          "reasons": ["terrorism", "kidnapping", "armed conflict"],
          "url": "https://...",
          "updated_at": "2026-02-20T00:00:00"
        }
      ]
    }
  ],
  "fetched_at": "2026-08-11T17:54:59"
}

Composite 1–5 risk score for a country, with the breakdown of how it was calculated.

Accepts: alpha-3 (USA) or alpha-2 (US).

{
  "iso_code": "TUR",
  "name": "Turkey",
  "risk_score": 2.0,
  "advisory_level": 2,
  "active_alerts": 6,
  "calculation": {
    "base_score": 2.0,
    "alert_modifier": 0.0
  }
}

Get a free API key. No card required — 100 requests/day. The key is also emailed to you.

curl -X POST https://api.travelriskapi.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Lost your key? We email it to the address it was registered with.

curl -X POST https://api.travelriskapi.com/api/v1/recover-key \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Your own consumption: today, this month, and a daily breakdown. Same numbers as the dashboard.

Current plans, limits and credit packs, straight from billing — so it can never drift from what you're charged.

Upgrading or buying credits is done from your dashboard.