Get Organization

This operation retrieves information for a specific organization. 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/organization/{organizationid}

Path Parameters:

{organizationid} the numeric identifier for a organization, replace with actual value, required

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/public/orgservice/organization/456?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/organization/456?api_key=YOUR_API_KEY"
               

XML Response:

            
                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                  <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>
               

Get Organization Response Structure

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