Examples:

Basic call with defaults

http://api.dhsprogram.com/rest/dhs/v8/countries



How to specify response type as json or xml

http://api.dhsprogram.com/rest/dhs/v8/countries/.json (return json for any call)
http://api.dhsprogram.com/rest/dhs/v8/countries?f=json

http://api.dhsprogram.com/rest/dhs/v8/countries/.xml (return xml for any call)
http://api.dhsprogram.com/rest/dhs/v8/countries?f=xml



Countries filtered by country or countries of interest

http://api.dhsprogram.com/rest/dhs/v8/countries?countryIds=EG (Egypt)

http://api.dhsprogram.com/rest/dhs/v8/countries/BJ,BF,CV,CI,GH,GN,LB,ML,MR,NI,NG,SN,SL,TG (Western Africa)



Countries limited to a specific survey

http://api.dhsprogram.com/rest/dhs/v8/countries/TZ2010DHS

http://api.dhsprogram.com/rest/dhs/v8/countries?surveyIds=TZ2010DHS



Filter on a specific year

http://api.dhsprogram.com/rest/dhs/v8/countries?surveyYear=2010



Find Countries in for a specific range of years

http://api.dhsprogram.com/rest/dhs/v8/countries/PK?surveyYearStart=2006

http://api.dhsprogram.com/rest/dhs/v8/countries/PK?surveyYearStart=1991&surveyYearEnd=2006



Pagination

http://api.dhsprogram.com/rest/dhs/v8/countries?perpage=50 (returns first 50 entries)

http://api.dhsprogram.com/rest/dhs/v8/countries?perpage=50&page=2 (returns second page of 50 entries)