This operation returns a signed URL that will allow you to download an XML file containing all organizations. 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 operation retrieves a signed link to a file containing information for all available organizations. This is a non-secure request as indicated by the '/public/' element in the URL path, however, the access token (authentication) is required.
GET
xml, json
xml, json
https://api.globalgiving.org/api/public/orgservice/all/organizations/download
https://api.globalgiving.org/api/public/orgservice/all/organizations/active/download
https://api.globalgiving.org/api/public/orgservice/all/organizations/vetted/download
&api_key described in the API Key section, required
/api/public/orgservice/all/organizations/download?api_key=YOUR_API_KEY
Variation | Path + Description |
---|---|
All | Returns all organizations on GlobalGiving.org, including organizations without active projects and ones with expired due diligence
/api/public/orgservice/all/organizations/download?api_key=YOUR_API_KEY |
Active | Returns all organizations on GlobalGiving.org with current, valid due diligence and an active project
/api/public/orgservice/all/organizations/active/download?api_key=YOUR_API_KEY |
Vetted | Returns all organizations on GlobalGiving.org with current, valid due diligence, including ones without any active projects
/api/public/orgservice/all/organizations/vetted/download?api_key=YOUR_API_KEY |
curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/public/orgservice/all/organizations/download?api_key=YOUR_API_KEY"
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<download>
<url>https://globalgiving-assets.s3.amazonaws.com/api/organizations.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20200624T172027Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIAWWX3N2JAEIZQOVVZ%2F20200624%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=69d4be158ab2a954fd87965acf5cf5da64930e51fa1ae73ef68199a8c884e679
</download>
* Note that each "&" is entity encoded as "&"
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<organizations numberFound="596">
<organization>
<activeProjects>12</activeProjects>
<addressLine1>Jl. Raya Cilebut No.32 Rt.02 Rw.11 Cilebut Timur</addressLine1>
<addressLine2>Sukaraja</addressLine2>
<city>Bogor</city>
<country>Indonesia</country>
<ein>30-0108263</ein>
<id>456</id>
<iso3166CountryCode>ID</iso3166CountryCode>
<logoUrl>https://www.globalgiving.org/pfil/organ/456/orglogo.jpg</logoUrl>
<mission>Our mission is to transform aid and philanthropy to accelerate community-led change.</mission>
<name>Centre for Community Development Studies (PUSPEM)</name>
<postal>16310</postal>
<state>DC</state>
<totalProjects>19</totalProjects>
<url>http://www.puspem.or.id</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>
.
.
<organization>
.......
</organization>
</organizations>
organizations |
|
Element | Mandatory | Description |
---|---|---|
activeProjects | required | Number of active Projects available for Org |
addressLine1 | optional | Line 1 of organization's address. |
addressLine2 | optional | Line 2 of organization's address. |
city | optional | City where organization resides. |
country | optional | Country where organization resides. |
iso3166CountryCode | optional | ISO-3166 Alpha-2 Country Code where organization resides. |
ein | optional | EIN number for Org (generally only available on US Orgs). |
id | required | Unique GlobalGiving identifier for organization. |
logoUrl | optional | URI for organization's logo. |
Mission | optional | Organization's mission statement. |
name | required | Organization's name. |
postal | optional | Organization's postal code. |
state | optional | Organization's state. |
totalProjects | required | total number of projects this organization has/had (inlcudes funded and retired projects). |
url | optional | URL to organization's website. |
themes | optional | one or more themes for this organization <themes> <theme> <id>edu</id> <name>Education</name> </theme> <theme> <id>env</id> <name>Environment</name> </theme> . . </themes> |
countries | optional | one or more countries the organization operates in <countries> <country> <iso3166CountryCode>ID</iso3166CountryCode> <name>Indonesia</name> </country> <country> <iso3166CountryCode>NG</iso3166CountryCode> <name>Nigeria</name> </country> . . </countries> |