surveys: Get list of surveys

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

Description

Returns metadata about DHS surveys including survey years, types, sample sizes, and fieldwork dates.

Parameters (3)

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

Output format.

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

page (integer, query, optional, default: 1)

Page number.

perpage (integer, query, optional, default: 100)

Number of entries per page.

Examples (2)

Get list of surveys openapi-spec
curl 'https://api.dhsprogram.com/rest/dhs/surveys?countryIds=NG%2CCD&surveyYearStart=2018&surveyYearEnd=2024&surveyCharacteristicIds=10%2C41'
import requests

resp = requests.get(
    "https://api.dhsprogram.com/rest/dhs/surveys",
    params={
        'countryIds': 'NG,CD',
        'surveyYearStart': '2018',
        'surveyYearEnd': '2024',
        'surveyCharacteristicIds': '10,41',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dhsprogram")
result = api.fetch("surveys", countryIds="NG,CD", surveyYearStart=2018, surveyYearEnd=2024, surveyCharacteristicIds="10,41")

for item in result:
    print(item)
const resp = await fetch("https://api.dhsprogram.com/rest/dhs/surveys?countryIds=NG%2CCD&surveyYearStart=2018&surveyYearEnd=2024&surveyCharacteristicIds=10%2C41");
const data = await resp.json();
Get list of surveys probe-gate
curl 'https://api.dhsprogram.com/rest/dhs/surveys?f=json&perpage=100&page=1'
import requests

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

api = zingu_apis.api("dhsprogram")
result = api.fetch("surveys", f="json", perpage=100, page=1)

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

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:33:24.383393 200 693ms
2026-04-16 01:50:57.193285 200 456ms
2026-04-16 01:06:36.336105 200 535ms
2026-04-15 03:13:07.776723 200 432ms
2026-04-15 01:15:14.567084 200 462ms
2026-04-14 04:08:44.421241 200 545ms
2026-04-14 02:34:43.997585 200 412ms
2026-04-12 16:06:58.212292 200 532ms
2026-04-12 14:57:44.412784 200 422ms
2026-04-10 04:22:43.623696 200 357ms
2026-04-10 02:46:15.664154 200 657ms
2026-04-09 02:13:16.924849 200 486ms
2026-04-09 00:37:42.576499 200 508ms
2026-04-08 00:14:02.674946 200 442ms
2026-04-08 00:12:25.842381 200 551ms
2026-04-07 01:26:51.926534 200 438ms
2026-04-07 01:09:21.100515 200 488ms
2026-04-06 05:21:20.225481 200 547ms
2026-04-06 04:47:31.897148 200 634ms
2026-04-05 02:46:56.176739 200 551ms
2026-04-05 02:42:54.716555 200 515ms
2026-04-04 02:39:03.525484 200 420ms
2026-04-04 02:02:03.038374 200 687ms
2026-04-03 12:39:30.466957 200 534ms
2026-04-03 12:30:52.455644 200 459ms
2026-03-30 02:55:39.378466 200 388ms
2026-03-30 02:47:37.220925 200 538ms
2026-03-29 13:35:32.672616 200 433ms
2026-03-29 13:24:29.659178 200 505ms
2026-03-23 10:45:17.227803 200 479ms
2026-03-23 09:26:38.649367 200 393ms