Get All Projects for a Country

This operation retrieves information for all projects in a specific country. The result set, however, is limited to a maximum of 10 results for every request. If there are more results available, the response will return two extra elements <hasNext> and <nextProjectId>. Note that these two elements are not present if there are no more available results. The <hasNext> element indicates whether there are more results available and the <nextProjectId> element indicates the next project id to include in the query string to retrieve the next set of results. This is a non-secure request as indicated by the '/public/' element in the URL path, therefore, an access token (authentication) is not required.

HTTP Method:


Content Type:

xml, json

Accept Type:

xml, json


Path Parameter:

{iso3166CountryCode} the ISO 3166 country code identifier for a specific country, replace with actual value, required

Query String Parameters:

&api_key described in the API Key section, required

&nextProjectId indicates the next project id to start the result set from, optional

Query String Example:



TIP: Adding '/active' to the path returns only active projects able to accept donations. Funded and retired projects are excluded.



HTTP GET Request using cURL:

                  curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET ""

XML Response:

                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                  <projects numberFound="3741">
                          <activities>Literacy, English, and income-generating skills classes are offered at the Women's Learning Center in Sar Asia and serve about 540 women per month. The clinic in Jaghartun provides over 2,500 patients per month with medical care and health education.</activities>
                          <contactAddress>Creating Hope International</contactAddress>
                          <contactAddress2>P. O. Box 1058</contactAddress2>
                          <contactCountry>United States</contactCountry>
                          <contactName>Toc Dunlap</contactName>
                                  <description>15 women will learn to read.</description>
                                  <description>5 women have cloth and tools for the tailoring course.</description>
                                  <description>42 women receive basic health care and health education.</description>
                          <image id="0">
                              <imagelink size="small">
                              <imagelink size="thumbnail">
                              <imagelink size="medium">
                              <imagelink size="large">
                              <imagelink size="extraLarge">
                              <imagelink size="original">
                              <title>Project Image Title</title>
                          <longTermImpact>A full array of medical and educational services are offered to hard-to-reach rural women and girls through Women's Learning Center sites at Jaghartun and Sar Asia. These centers improve the education and health of Afghan women in the region.</longTermImpact>
                          <need>No education has been available to women and girls in the western province of Herat, Afghanistan, for the last decade under the Taliban regime. Project partner AIL began offering Women's Learning Centers to women and girls in rural Herat during 2003. These health and education services at Sar Asia and Jaghartun include a maternal/child health clinic, literacy and skills training classes. This project will ensure continuation of these urgently needed, accessible, culturally sensitive services.</need>
                              <addressLine1>SAMADHAN'S HUMAN RESOURCE CENTER Pocket 2, Sector 2,</addressLine1>
                              <mission>To make the world a better place</mission>
                              <postal>110 047</postal>
                          <region>Asia and Oceania</region>
                          <summary>Empowering rural Afghan women and girls in Sar Asia and Jaghartun, Herat, through education and training opportunities as well as health and reproductive health services.</summary>
                          <title>Learning Centers for Rural Women in Herat</title>

NOTE: The <project> element is repeating.

See Get All Projects Response Structure

See Element Definitions for Get All Projects Response