Start here
This answers a question that sounds simple and usually is not: does this country have the people to do the work? “The people” breaks into three separate things, and a country can be strong in one and hollow in another:- Enough working-age people — now, and still in ten years’ time.
- A pipeline producing skills — universities, STEM graduates, researchers.
- A workforce that can actually build things — trained industrial trades, machine operators, manufacturing employment.
Access. Served from
GET /api/resilience/v1/get-demographics-capability?countryCode=<ISO2> and MCP get_demographics_capability. Both require a Pro subscription.Three independent groups
The response is deliberately not a single blended index. Each group resolves on its own, from its own source, on its own clock.Age structure — UN World Population Prospects
medianAgeYears, workingAgePopulationPeople, oldAgeDependencyRatioPercent, totalDependencyRatioPercent, and a forward workingAgePopulationProjected10yPeople. WPP publishes revisions every two years; between revisions the projection is the same series, not a fresh estimate.
Education pipeline — UNESCO UIS and World Bank WDI
tertiaryEnrollmentGrossPercent, stemGraduatesSharePercent, and researchersPerMillion. UIS is primary; WDI fills where UIS coverage lapses. Reporting lag is long — three to five years is ordinary, not a fault.
Industrial workforce — ILOSTAT
manufacturingEmploymentSharePercent, trainedIndustrialWorkforcePeople, craftTradesEmploymentPeople, and plantMachineOperatorsEmploymentPeople. ILOSTAT coverage is the thinnest of the three: a country can have current WPP age structure and no usable ILOSTAT observation at all.
Reading the response
Every metric carries its value,year, source, unit, and an explicit available flag. An optional sourceStatus preserves supplied provider status metadata.
Read available before the value. An absent proto3 number serializes as 0. A supplied zero with available: true remains a valid value. Availability does not establish that the value is observed or unestimated.
Read source status separately. ILOSTAT statuses such as Imputation, Estimate, and Adjusted come from its official status code list. World Bank forecast status comes from its API observation-status metadata. Notes for sums and ratios identify their input statuses. If any input status is missing, the note includes Not supplied. When no status is supplied, the display says Estimate and imputation status not supplied. A modelled source name alone does not identify which individual values were imputed. Available observations in older snapshots without sourceStatus show the same missing-status disclosure until a source refresh supplies status metadata.
Do not average across groups. They have different vintages and different coverage. A country whose ILOSTAT row is eight years old and whose WPP row is current does not have an eight-year-old demographic profile; it has two observations that must be read separately. The response keeps them apart for that reason.
Retention lives on stages[].status, not on each value. A stage is fresh, retained, or unavailable. retained means that source group was carried forward from a previous fetch because the current upstream request failed. Individual observations have no retained field.
The top-level available: false means no group resolved at all — the country has no usable observation in any of the three, which is different from a country whose groups each carry their own partial availability.
Cadence
The seeder refreshes on the slowest useful cycle for the set. Upstream publication is the binding constraint: WPP every two years, UIS and WDI annually with multi-year lag, ILOSTAT irregularly by country.Related
- Pro Intelligence Suite
- Five-factor scorecard — consumes these observations as its demographics pillar
- Country resilience index
- Data sources
