Humanitarian

Current Humanitarian Context

Africa API exposes UNHCR displacement totals through:

• GET /v1/countries/{country_code}/signals
• GET /v1/data?metric_key=...&latest=true

This gives you official country-level humanitarian context without leaving the core API surface.

Available Metrics

• refugees_hosted_total
• asylum_seekers_hosted_total
• idps_total
• stateless_total

These figures come from the UNHCR Refugee Statistics API population dataset and are keyed to the country of asylum or reporting country.

Example

curl "https://api.africa-api.com/v1/countries/ug/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

{
  "metric_key": "refugees_hosted_total",
  "metric_name": "Refugees Hosted",
  "category": "humanitarian",
  "frequency": "annual",
  "year": 2025,
  "value": 1789456,
  "unit": "persons",
  "source": "unhcr_displacement_signals",
  "value_status": "reported",
  "freshness": "recent",
  "retrieved_at": "2026-03-13T18:00:00Z"
}

Notes

• These are official annual totals, so they usually show up as recent rather than current in signals.
• Countries with no published UNHCR country row simply omit these metrics.
• Use /v1/data if you want to pin a specific metric key or compare countries directly.