This operation retrieves information for all projects in a specific country or region. 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.
GET
xml, json
xml, json
https://api.globalgiving.org/api/public/projectservice/countries/{iso3166CountryCode}/projects
{iso3166CountryCode} the ISO 3166 country code identifier for a specific country, replace with actual value, required
&api_key described in the API Key section, required
&nextProjectId indicates the next project id to start the result set from, optional
/api/public/projectservice/countries/IN/projects?api_key=YOUR_API_KEY
Tip:
Adding '/active' to the path returns only active projects able to accept donations. Funded
and retired projects are excluded.
Example:
/api/public/projectservice/countries/IN/projects/active?api_key=YOUR_API_KEY
curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/public/projectservice/countries/IN/projects?api_key=YOUR_API_KEY"
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<projects numberFound="3741">
<hasNext>true</hasNext>
<nextProjectId>364</nextProjectId>
<project>
<active>true</active>
<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>
<additionalDocumentation>https://www.globalgiving.org/pfil/364/projdoc.doc</additionalDocumentation>
<approvedDate>2006-10-11T17:21:55-07:00</approvedDate>
<contactAddress>Creating Hope International</contactAddress>
<contactAddress2>P. O. Box 1058</contactAddress2>
<contactCity>Dearborn</contactCity>
<contactCountry>United States</contactCountry>
<contactName>Toc Dunlap</contactName>
<contactPostal>48121</contactPostal>
<contactState>Michigan</contactState>
<contactTitle>President</contactTitle>
<contactUrl>https://www.creatinghope.org</contactUrl>
<country>Afghanistan</country>
<countries>
<country>
<iso3166CountryCode>AF</iso3166CountryCode>
<name>Afghanistan</name>
</country>
</countries>
<dateOfMostRecentReport>2020-05-05T12:20:05-04:00</dateOfMostRecentReport>
<donationOptions>
<donationOption>
<amount>25</amount>
<description>15 women will learn to read.</description>
</donationOption>
<donationOption>
<amount>50</amount>
<description>5 women have cloth and tools for the tailoring course.</description>
</donationOption>
<donationOption>
<amount>75</amount>
<description>42 women receive basic health care and health education.</description>
</donationOption>
</donationOptions>
<funding>3908.0</funding>
<goal>7260</goal>
<id>354</id>
<imageGallerySize>11</imageGallerySize>
<imageLink>https://www.globalgiving.org/pfil/354/pict.jpg</imageLink>
<image id="0">
<imagelink size="small">
<url>https://www.globalgiving.org/pfil/354/pict_grid1.jpg</url>
</imagelink>
<imagelink size="thumbnail">
<url>https://www.globalgiving.org/pfil/354/pict_thumbnail.jpg</url>
</imagelink>
<imagelink size="medium">
<url>https://www.globalgiving.org/pfil/354/pict_med.jpg</url>
</imagelink>
<imagelink size="large">
<url>https://www.globalgiving.org/pfil/354/pict_grid7.jpg</url>
</imagelink>
<imagelink size="extraLarge">
<url>https://www.globalgiving.org/pfil/354/pict_large.jpg</url>
</imagelink>
<imagelink size="original">
<url>https://www.globalgiving.org/pfil/354/pict_original.jpg</url>
</imagelink>
<title>Project Image Title</title>
</image>
<iso3166CountryCode>AF</iso3166CountryCode>
<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>
<modifiedDate>2020-06-07T05:25:49-04:00</modifiedDate>
<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>
<notice>Important Notice about Projects in India: We are currently expecting delays in getting funds to this project due to new regulatory requirements that impact GlobalGiving’s ability to disburse to some organizations in India. GlobalGiving is working hard to address the issue. Donations to this project will be disbursed as quickly as possible.</notice>
<numberOfDonations>33</numberOfDonations>
<numberOfReports>73</numberOfReports>
<organization>
<activeProjects>2</activeProjects>
<addressLine1>SAMADHAN'S HUMAN RESOURCE CENTER Pocket 2, Sector 2,</addressLine1>
<city>DWARKA</city>
<country>India</country>
<id>11</id>
<iso3166CountryCode>IN</iso3166CountryCode>
<mission>To make the world a better place</mission>
<name>Samadhan</name>
<postal>110 047</postal>
<totalProjects>2</totalProjects>
<url>http://www.samadhanindia.org</url>
<themes>
<theme>
<id>edu</id>
<name>Education</name>
</theme>
<theme>
<id>env</id>
<name>Environment</name>
</theme>
</themes>
<countries>
<country>
<iso3166CountryCode>ID</iso3166CountryCode>
<name>Indonesia</name>
</country>
<country>
<iso3166CountryCode>NG</iso3166CountryCode>
<name>Nigeria</name>
</country>
</countries>
</organization>
<progressReportLink>https://www.globalgiving.org/projects/help-disabled-children-in-india/updates/</progressReportLink>
<projectLink>https://www.globalgiving.org/projects/help-disabled-children-in-india/</projectLink>
<region>Asia and Oceania</region>
<remaining>3352.0</remaining>
<status>active</status>
<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>
<themeName>Education</themeName>
<themes>
<theme>
<id>edu</id>
<name>Education</name>
</theme>
<theme>
<id>children</id>
<name>Children</name>
</theme>
</themes>
<title>Learning Centers for Rural Women in Herat</title>
<type>project</type>
<videos>
<video>
<url>http://www.youtube.com/v/MfYzBQhkbDw&hl=en_US&fs=1&</url>
</video>
</videos>
</project>
.
.
<project>
......
</project>
</projects>
NOTE: The <project> element is repeating.