data: Get survey data

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

Description

Returns actual survey data values for specified indicators, countries, and years. This is the primary endpoint for retrieving statistical data.

Parameters (5)

breakdown (string, query, optional)

Data breakdown level (e.g., 'subnational' for regional data, 'total' for national aggregates)

Constraints: {'enum': ['total', 'subnational']}

countryIds (string, query, required)

Comma-separated list of DHS country codes (e.g., 'GH,KE,NG')

f (string, query, optional, default: json)

Response format (json or xml)

Constraints: {'enum': ['json', 'xml']}

indicatorIds (string, query, required)

Comma-separated list of indicator IDs (e.g., 'FE_FRTR_W_A15,FE_FRTR_W_A20')

surveyYear (string, query, required)

Survey year to retrieve data for

Examples (2)

Get fertility rate data for Nigeria probe-gate
curl 'https://api.dhsprogram.com/rest/dhs/data?f=json&countryIds=NG&indicatorIds=FE_FRTR_W_TFR&surveyYear=2018'
import requests

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

api = zingu_apis.api("dhsprogram")
result = api.fetch("rest/dhs/data", f="json", countryIds="NG", indicatorIds="FE_FRTR_W_TFR", surveyYear=2018)

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/data?f=json&countryIds=NG&indicatorIds=FE_FRTR_W_TFR&surveyYear=2018");
const data = await resp.json();
Get malaria indicator data probe-gate
curl 'https://api.dhsprogram.com/rest/dhs/data?f=json&countryIds=UG&indicatorIds=ML_PMAL_C_RDT&perpage=10'
import requests

resp = requests.get(
    "https://api.dhsprogram.com/rest/dhs/data",
    params={
        'f': 'json',
        'countryIds': 'UG',
        'indicatorIds': 'ML_PMAL_C_RDT',
        'perpage': '10',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dhsprogram")
result = api.fetch("rest/dhs/data", f="json", countryIds="UG", indicatorIds="ML_PMAL_C_RDT", perpage=10)

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/data?f=json&countryIds=UG&indicatorIds=ML_PMAL_C_RDT&perpage=10");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 00:25:24.323737 200 424ms
2026-04-16 00:12:47.993534 200 520ms
2026-04-15 03:32:09.236210 200 458ms
2026-04-15 00:21:25.435427 200 456ms
2026-04-14 03:41:22.263358 200 455ms
2026-04-14 00:11:14.166001 200 594ms
2026-04-12 15:51:22.003881 200 433ms
2026-04-12 13:07:37.785744 200 413ms
2026-04-10 04:28:14.293544 200 354ms
2026-04-10 01:59:32.795044 200 386ms
2026-04-09 03:33:31.124082 200 404ms
2026-04-09 01:06:41.422252 200 422ms
2026-04-08 07:36:11.139235 200 424ms
2026-04-08 06:57:19.454894 200 455ms
2026-04-07 01:34:16.095675 200 432ms
2026-04-07 00:43:17.371971 200 427ms
2026-04-05 22:50:39.642053 200 2600ms
2026-04-05 18:58:46.520025 ERR
2026-04-05 01:42:04.884226 200 521ms
2026-04-05 00:55:34.303846 200 816ms
2026-04-04 03:18:28.563646 200 594ms
2026-04-04 02:40:05.977755 200 380ms
2026-04-03 13:18:29.875056 200 394ms
2026-04-03 13:11:16.164522 200 418ms
2026-03-30 03:09:29.576079 200 419ms
2026-03-30 02:34:42.064340 200 529ms
2026-03-29 13:19:44.332288 200 376ms
2026-03-29 13:13:56.967051 200 443ms