Get Themes with Project Ids

This operation retrieves all GlobalGiving themes with their associated project ids. 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/projectservice/themes/projects/ids

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/public/projectservice/themes/projects/ids?api_key=YOUR_API_KEY

tip

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

Example:

/api/public/projectservice/themes/projects/active/ids?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/projectservice/themes/projects/ids?api_key=YOUR_API_KEY"

XML Response:

            
                  <?xml version="1.0" encoding="utf-8" standalone="yes"?>
                  <themes>
                     <theme>
                        <id>edu</id>
                        <name>Education</name>
                        <projects>
                           <project>
                              <id>354</id>
                           </project>
                           <project>
                              <id>358</id>
                           </project>
                           <project>
                              <id>921</id>
                           </project>
                           .
                           .
                        </projects>
                     </theme>
                     <theme>
                        <id>env</id>
                        <name>Environment</name>
                        .
                        .
                     </theme>
                     .
                     .
                  </themes>

NOTE: The <theme> and <project> elements are repeating.

Get Themes with Project Ids Response Structure

themes

theme [one or more]

id string
name string
projects

project [one or more]

id int

Element Definitions For Get Themes With Project Ids Response

Element Mandatory Description
themes -> theme -> id required Unique identifier for theme.
name required Name of theme.
themes -> theme -> projects -> project -> id required Unique identifier for a GlobalGiving project.