Governance And Conflict

Governance And Conflict In Africa API

Governance and organized-conflict data are exposed through the shared indicator and data endpoints.

Current coverage combines the World Bank Worldwide Governance Indicators series with the Uppsala Conflict Data Program (UCDP) Country-Year Dataset.

Use:

• GET /v1/indicators?category=governance
• GET /v1/data?category=governance
• GET /v1/indicators/{metric_key}/rankings
• GET /v1/countries/{country_code}/profile

Institutional Governance Metrics

• voice_accountability_estimate
• political_stability_estimate
• government_effectiveness_estimate
• regulatory_quality_estimate
• rule_of_law_estimate
• control_of_corruption_estimate

These are annual country-level estimates. Check the indicator catalog for country and year coverage.

Organized-Violence Metrics

• organized_violence_deaths_estimate
• state_based_conflict_dyads_total
• non_state_conflict_dyads_total
• one_sided_violence_dyads_total

The documented UCDP release, version 26.1, covers 54 African countries from 1989 through 2025. A dyad metric counts active conflict pairs; it is not a fatality count or a composite country-risk score.

Example Queries

curl "https://api.africa-api.com/v1/indicators?category=governance&has_data=true" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

curl "https://api.africa-api.com/v1/data?country_codes=gh,ke,ng,za&metric_key=government_effectiveness_estimate&year=2024" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

curl "https://api.africa-api.com/v1/indicators/control_of_corruption_estimate/rankings?year=2024&limit=10" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

To filter UCDP observations to Nigeria and 2025:

curl "https://api.africa-api.com/v1/data?country_code=NG&year=2025&source=ucdp_organized_violence&limit=4" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

Selected fields from the recorded production response for dataset version 26.1:

{
  "data": [
    {
      "country_code": "ng",
      "metric_key": "non_state_conflict_dyads_total",
      "year": 2025,
      "value": 28.0,
      "value_status": "estimated",
      "dataset_version": "26.1"
    },
    {
      "country_code": "ng",
      "metric_key": "one_sided_violence_dyads_total",
      "year": 2025,
      "value": 10.0,
      "value_status": "estimated",
      "dataset_version": "26.1"
    },
    {
      "country_code": "ng",
      "metric_key": "organized_violence_deaths_estimate",
      "year": 2025,
      "value": 4158.0,
      "estimate_low": 3548.0,
      "estimate_high": 4774.0,
      "value_status": "estimated",
      "dataset_version": "26.1"
    },
    {
      "country_code": "ng",
      "metric_key": "state_based_conflict_dyads_total",
      "year": 2025,
      "value": 3.0,
      "value_status": "estimated",
      "dataset_version": "26.1"
    }
  ],
  "meta": { "total": 4, "limit": 4 }
}

The request filters by country, year, and source; it does not pin a dataset version. Save the response and its dataset_version if you need to reproduce an analysis after a later source release.

For organized_violence_deaths_estimate, value is UCDP's best estimate. Preserve estimate_low and estimate_high when uncertainty matters. Do not describe the best estimate as a reported exact death count.

Important Scope Note

Governance and conflict indicators are not the same thing as historical government records.

Use Government for leaders and cabinets, Elections for election events, and Policies for policy documents and legal acts.