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

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>