This operation retrieves a progress report(s) for a specific project with the results returned in the Atom standard. Therefore, to receive a response in XML the Accept header must be set to 'Accept: application/atom+xml'. 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
atom+xml, json
https://api.globalgiving.org/api/public/projectservice/projects/{projectid}/reports
{projectid} the numeric identifier for a project, replace with actual value, required
&api_key described in the API Key section, required
/api/public/projectservice/projects/1883/reports?api_key=YOUR_API_KEY
curl -H "Accept: application/atom+xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/public/projectservice/projects/1883/reports?api_key=YOUR_API_KEY"
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:xml="http://www.w3.org/XML/1998/namespace" xml:base="https://www.globalgiving.org/projects/hunger-in-africa/">
<title type="text">Fight child hunger in Niger</title>
<updated>2020-06-07T05:26:52.000Z</updated>
<id>https://www.globalgiving.org</id>
<author>
<name>GlobalGiving</name>
</author>
<link href="https://www.globalgiving.org/projects/hunger-in-africa/updates/" rel="self" />
<entry>
<id>https://www.globalgiving.org/projects/hunger-in-africa/updates/?subid=730</id>
<published>2007-01-23T23:14:18.000Z</published>
<content type="text">In February 2005, the World Food Program (WFP) launched an Emergency Operation initially aimed at preventing vulnerable populations from sliding into a crisis situation. Supporting Niger’s National Mechanism for the Prevention
and Management of Food Crises (DNPGCA), WFP provided food aid in a variety of ways. This included take-home rations for the families of malnourished children undergoing treatment in therapeutic feeding centers; food for nomadic herders; and rations
to support Food for Work activities.
In July, as the DNPGCA’s stocks of food and funding dwindled, WFP expanded its operations to provide free food to households severely impacted by malnutrition. Principal WFP food aid activities are outlined
below. To date, WFP’s Emergency Operation has provided food for nearly 3 million people.
Click below to read the complete report on WFP's work in Niger.</content>
<title type="text">Niger Emergency Operation Report</title>
<author>
<name>World Food Programme</name>
</author>
<link href="https://www.globalgiving.org/pfil/1082/Niger+Emergency+Operations+Report.doc" />
</entry>
.
.
</feed>
NOTE: There may be zero or more <entry> elements.
Conforms to the Atom Syndication Format
feed
|
|
Element | Mandatory | Description |
---|---|---|
title | required | Title of project. |
feed -> id | required | GlobalGiving URI. |
feed -> author -> name | required | Publisher of entire feed, in this case, GlobalGiving. |
link [href] attribute | required | URL to project's progress reports parent page on GlobalGiving site. |
link [rel] attribute | required | The value "self" indicating the value of the href attribute identifies a resource equivalent to the containing element. |
feed -> entry -> id | required | URL to project's specific progress report entry page on GlobalGiving site. |
published | required | Date time stamp of when update was published (format YYYY-MM-DDThh:mm:ss[.s[s*]][TZD]). |
content | required | Progress reports contents. |
title | required | Title for progress report. |
feed -> entry -> author -> name | required | Author progress report. |
feed -> entry -> link [href] attribute | required | URI to an extra resource associated with this progress report content, such as an image, Word document, or PDF file. |