Get All Organizations

Get All Organizations (bulk download)

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.

HTTP Method:

GET

Content Type:

xml, json

Accept Type:

xml, json

Path:

https://api.globalgiving.org/api/public/orgservice/all/organizations/download

Variations:

https://api.globalgiving.org/api/public/orgservice/all/organizations/active/download

https://api.globalgiving.org/api/public/orgservice/all/organizations/vetted/download

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/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

HTTP GET Request using cURL:

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 Response:

<?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&amp;X-Amz-Date=20200624T172027Z&amp;X-Amz-SignedHeaders=host&amp;X-Amz-Expires=3600&amp;X-Amz-Credential=AKIAWWX3N2JAEIZQOVVZ%2F20200624%2Fus-east-1%2Fs3%2Faws4_request&amp;X-Amz-Signature=69d4be158ab2a954fd87965acf5cf5da64930e51fa1ae73ef68199a8c884e679
</download>

* Note that each "&" is entity encoded as "&"

XML Document Contents:

<?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>

Get All Organization Response Structure

organizations

organization

activeProjects	int
addressLine1	string
addressLine2	string
city	string
country	string
iso3166CountryCode	string
ein	string
id	int
logoUrl	string
mission	string
name	string
postal	string
state	string
totalProjects	int
url	string
themes	xml
countries	xml

Element Definitions for Get All Organization Response

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>