Get All Active Projects (Bulk Download)

This operation returns a signed URL that will allow you to download an XML file containing all active projects. The file follows the same format as https://api.globalgiving.org/api/public/projectservice/all/projects/active but contains the complete list in one large file. This eliminates the need to make numerous calls to the Get All Projects endpoint. The bulk file is updated once a day so you only need to update your cache at most once a day using this method.

Note that only the XML format is available for download. You may request the URL using JSON, but the URL will always lead to the XML 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:

GET

Content Type:

xml, json

Accept Type:

xml, json

Path:

https://api.globalgiving.org/api/public/projectservice/all/projects/active/download.xml

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/public/projectservice/all/projects/active/download.xml?api_key=YOUR_API_KEY

HTTP GET Request using cURL:

curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/public/projectservice/all/projects/active/download.xml?api_key=YOUR_API_KEY"

Sample XML Response:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<download>
    <url>https://globalgiving-assets.s3.amazonaws.com/api/active_projects.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20200101T210221Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3599&X-Amz-Credential=XXXXXXXXXXXX%2F20190530%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
</download>
  • The URL is only valid for 1 hour from when you make the request to GlobalGiving's API.
  • If you are using an XML decoding library, then this will work fine. Otherwise you will need to replace "&" with "&" in the URL.
  • Import the data in the downloaded files. It is in the same format as Get All Projects
WARNING: Javascript is currently disabled or is not available in your browser. GlobalGiving makes extensive use of Javascript and will not function properly with Javascript disabled. Please enable Javascript and refresh this page.