GET data
dhsprogram.com:dhs-program-api
Summary: Get survey indicator data
Operation ID: getData
Auth: unknown
Operation ID: getData
Auth: unknown
Description
Returns indicator data from DHS surveys. Supports filtering by country, indicator, survey year, and other parameters. Data includes fertility rates, mortality rates, health indicators, and demographic statistics.
Parameters (10)
breakdown
(string, query, optional)
Data aggregation level: national, subnational, or all.
Constraints: {'enum': ['national', 'subnational', 'all']}
countryIds
(string, query, optional)
Filter by country code(s). Use comma-separated values for multiple countries (e.g., KE,EG for Kenya and Egypt).
f
(string, query, optional, default: json)
Output format.
Constraints: {'enum': ['json', 'xml', 'html', 'csv', 'geojson']}
indicatorIds
(string, query, optional)
Filter by indicator ID(s). Use comma-separated values for multiple indicators.
page
(integer, query, optional, default: 1)
Page number for pagination.
perpage
(integer, query, optional, default: 100)
Number of entries per page.
surveyIds
(string, query, optional)
Filter by specific survey ID(s).
surveyYear
(integer, query, optional)
Filter by survey year.
surveyYearEnd
(integer, query, optional)
Filter by end survey year (for range queries).
surveyYearStart
(integer, query, optional)
Filter by start survey year (for range queries).
Examples (3)
| Title | Type | URL | Action |
|---|---|---|---|
| Get indicator data | openapi-spec |
https://api.dhsprogram.com/rest/dhs/data?countryIds=NG,CD&surveyIds=NG2018DHS,CD2013DHS&indicatorIds=FE_FRTR_W_TFR,ML_PMAL_C_RDT&surveyYearStart=2018&surveyYearEnd=2024&characteristicCategory=Age&characteristicLabel=15-19&returnFields=Indicator,Value,SurveyYear |
|
| Get survey indicator data | openapi-spec |
https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020 |
|
| Get survey indicator data | probe-gate |
https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020&f=json&perpage=100&page=1 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:14:01.576232 | ERR | — | |
| 2026-03-23 09:34:33.376155 | ERR | — | |
| 2026-03-23 09:10:43.568695 | 200 | 365ms |