INFORM Severity Index (TRIPWIRE)

CEV-OS / Data API / INFORM Severity Index (TRIPWIRE)

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need the monthly INFORM humanitarian crisis severity (1-5) for a country or the current list of scored crises.

What it is

The INFORM Severity Index (EU JRC methodology, ACAPS data, OCHA coordination) as used by the TRIPWIRE map: one row per country (ISO 3166-1 alpha-2) plus the underlying crisis rows, with category (Very Low to Very High), the 1-10 score rounded to one decimal, trend and drivers. Tripwire maps published ISO3 codes to ISO2; scores are the published values (CC BY 4.0; that mapping is marked). No coordinates. Not for operational targeting of a single crisis. Source file: monthly Excel on HDX (not the ACAPS API).

Endpoints

REST: GET /v1/inform-severity on https://api.cev-os.com
Legacy host (same service): GET /v1/inform-severity on https://cev-os.com
MCP tool: get_inform_severity on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/inform-severity`
Name	Type	Description	Constraints
`country`	string	ISO 3166-1 alpha-2 country code.	example SD; pattern ^[A-Za-z]{2}$

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/inform-severity?country=SD"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "release": "October 2026",
  "count": 1,
  "crises_count": 1,
  "stale": false,
  "countries": [
    {
      "country": "SD",
      "country_name": "Sudan",
      "iso3": "SDN",
      "severity": 5,
      "category": "Very High",
      "score": 4.6,
      "crisis": "Sudan Complex Crisis",
      "crisis_id": "SDN001",
      "trend": "Stable",
      "drivers": null
    }
  ],
  "crises": [
    {
      "country": "SD",
      "country_name": "Sudan",
      "iso3": "SDN",
      "severity": 5,
      "category": "Very High",
      "score": 4.6,
      "crisis": "Sudan Complex Crisis",
      "crisis_id": "SDN001",
      "trend": "Stable",
      "drivers": null
    }
  ]
}

Update frequency

HDX publishes a monthly Excel; TRIPWIRE re-downloads at most every 25 days and the Data API caches 1 h.

Public cache: 3600 seconds (Cache-Control: public, max-age=3600).

Sources, license and usage

License status: cleared with attribution. INFORM Severity Index, CC BY 4.0. Commercial reuse allowed with attribution; Tripwire's ISO3→ISO2 mapping and country-centroid placement are marked modifications. Scores are unchanged.

Underlying sources
Source	License	commercialOk	Terms
INFORM Severity Index (EU JRC / ACAPS / OCHA)	CC BY 4.0; commercial reuse allowed with attribution; modifications must be marked	true	https://creativecommons.org/licenses/by/4.0/

Attribution (show this wherever you display the data):

INFORM Severity Index (EU JRC / ACAPS / OCHA), CC BY 4.0. Tripwire maps published country scores to ISO 3166-1 alpha-2; scores are unchanged. https://drmkc.jrc.ec.europa.eu/inform-index/INFORM-Severity

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Gaps

No coordinates (the Data API carries none); country markers on the TRIPWIRE map use Natural Earth centroids.
Coverage is countries INFORM scores; small territories without an ISO2 mapping are omitted.

Disclaimer

Informational. Not for operational targeting, life-safety or humanitarian allocation decisions.

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products

Reference data, not investment advice.