Get All Organizations

This operation retrieves information for all available organizations. 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 <nextOrgId>. 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 <nextOrgId> element indicates the next organization 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.

HTTP Method:

GET

Content Type:

xml, json

Accept Type:

xml, json

Path:

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

Query String Parameters:

&api_key described in the API Key section, required

&nextOrgId indicates the next organizatoin id to start the result set from, optional

Query String Example:

/api/public/orgservice/organizations?api_key=YOUR_API_KEY&nextOrgId=348

tip

TIP: Adding '/active' to the path returns only organizations that have active projects able to accept donations. Funded and retired projects are excluded.

Example:

/api/public/orgservice/all/organizations/active?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/organizations?api_key=YOUR_API_KEY"
               

XML Response:

            
                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                  <organizations>
                      <hasNext>true</hasNext>
                      <nextOrgId>348</nextOrgId>
                      <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>http://cloud.globalgiving.org/pfil/organ/456/orglogo.jpg</logoUrl>
                          <mission>Our mission is to catalyze a global market for ideas, information, and money that democratizes aid and philanthropy.</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
hasNext boolean
nextOrgId int
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
hasNext optional true if there are more organizations to get
nextOrgId optional If present, the next OrgId to use in &nextOrgId on subsequent call.
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>