Demographics

This domain is rolling out. Endpoints and response shapes may evolve before stabilization.

Domain Objective

The demographics domain is designed for products that need:

Population size and growth context
Age-bucket composition
Urbanization and long-term trend analysis

Platform Contract Expectations

This domain follows the same platform conventions:

Versioned paths under /v1
Standard response envelope patterns
Shared auth and error handling model

Planned Paths

GET /v1/demographics/{country_code}
GET /v1/demographics/{country_code}/historical

Expected Response Shape

{
  "data": {
    "country_code": "ng",
    "population": 223804632,
    "growth_rate_pct": 2.41,
    "median_age": 18.1,
    "urban_population_pct": 54.3,
    "age_buckets": {
      "0_14": 42.5,
      "15_64": 54.3,
      "65_plus": 3.2
    },
    "source": "UN World Population Prospects 2024",
    "year": 2024
  }
}

Integration Readiness

Model this domain in your client now as a module boundary, so rollout requires minimal application changes.

Countries

Start with the live foundational domain.

Platform Overview

Review platform standards and domain roadmap.