data: Get survey indicator data

API: dhsprogram.com:dhs-program-api
Endpoint: /data
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 410ms

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)

Get indicator data openapi-spec
curl 'https://api.dhsprogram.com/rest/dhs/data?countryIds=NG%2CCD&surveyIds=NG2018DHS%2CCD2013DHS&indicatorIds=FE_FRTR_W_TFR%2CML_PMAL_C_RDT&surveyYearStart=2018&surveyYearEnd=2024&characteristicCategory=Age&characteristicLabel=15-19&returnFields=Indicator%2CValue%2CSurveyYear'
import requests

resp = requests.get(
    "https://api.dhsprogram.com/rest/dhs/data",
    params={
        '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',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dhsprogram")
result = api.fetch("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")

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/data?countryIds=NG%2CCD&surveyIds=NG2018DHS%2CCD2013DHS&indicatorIds=FE_FRTR_W_TFR%2CML_PMAL_C_RDT&surveyYearStart=2018&surveyYearEnd=2024&characteristicCategory=Age&characteristicLabel=15-19&returnFields=Indicator%2CValue%2CSurveyYear");
const data = await resp.json();
Get survey indicator data openapi-spec
curl 'https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020'
import requests

resp = requests.get(
    "https://api.dhsprogram.com/rest/dhs/data",
    params={
        'countryIds': 'KE',
        'indicatorIds': 'FE_FRTR_W_TFR',
        'surveyYear': '2020',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dhsprogram")
result = api.fetch("data", countryIds="KE", indicatorIds="FE_FRTR_W_TFR", surveyYear=2020)

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020");
const data = await resp.json();
Get survey indicator data probe-gate
curl 'https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020&f=json&perpage=100&page=1'
import requests

resp = requests.get(
    "https://api.dhsprogram.com/rest/dhs/data",
    params={
        'countryIds': 'KE',
        'indicatorIds': 'FE_FRTR_W_TFR',
        'surveyYear': '2020',
        'f': 'json',
        'perpage': '100',
        'page': '1',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dhsprogram")
result = api.fetch("data", countryIds="KE", indicatorIds="FE_FRTR_W_TFR", surveyYear=2020, f="json", perpage=100, page=1)

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/data?countryIds=KE&indicatorIds=FE_FRTR_W_TFR&surveyYear=2020&f=json&perpage=100&page=1");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:40:58.226520 200 410ms
2026-04-16 02:07:48.849267 200 398ms
2026-04-16 01:19:40.222027 200 462ms
2026-04-16 00:54:13.265916 200 478ms
2026-04-15 03:42:31.034091 200 392ms
2026-04-15 03:41:29.218005 200 466ms
2026-04-15 02:44:19.669154 200 507ms
2026-04-14 02:09:17.567403 200 424ms
2026-04-14 01:41:18.308776 200 632ms
2026-04-14 01:14:18.298417 200 426ms
2026-04-12 16:17:05.742318 200 470ms
2026-04-12 16:05:40.319549 200 596ms
2026-04-12 13:53:46.427866 200 458ms
2026-04-10 04:16:27.047852 200 361ms
2026-04-10 02:26:29.645062 200 526ms
2026-04-10 00:46:38.107135 200 380ms
2026-04-09 03:50:11.555298 200 496ms
2026-04-09 03:14:19.540070 200 602ms
2026-04-09 02:12:02.594950 200 443ms
2026-04-08 07:33:11.939920 200 427ms
2026-04-08 07:29:25.654524 200 464ms
2026-04-08 00:59:18.100909 200 644ms
2026-04-07 01:29:43.067617 200 430ms
2026-04-07 01:08:11.188940 200 699ms
2026-04-07 00:44:46.708736 200 426ms
2026-04-06 04:25:45.854068 200 523ms
2026-04-06 00:31:32.442351 200 566ms
2026-04-05 20:04:37.698156 503 2849ms
2026-04-05 02:23:31.411228 200 537ms
2026-04-05 01:41:02.638506 200 584ms
2026-04-05 00:04:44.455409 200 706ms
2026-04-04 03:22:43.712045 200 416ms
2026-04-04 02:41:07.348342 200 424ms
2026-04-04 02:21:39.940441 200 423ms
2026-04-03 12:45:34.500132 200 442ms
2026-04-03 12:40:49.121579 200 459ms
2026-04-03 12:26:12.109141 200 504ms
2026-03-30 02:54:35.600879 200 435ms
2026-03-30 02:43:42.095749 200 402ms
2026-03-30 02:42:39.700173 200 436ms
2026-03-29 13:08:50.910299 200 402ms
2026-03-29 13:00:56.199678 200 474ms
2026-03-29 12:47:32.138329 200 493ms
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