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:
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 numberFound="878">
         <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.
WARNING: Javascript is currently disabled or is not available in your browser. GlobalGiving makes extensive use of Javascript and will not function properly with Javascript disabled. Please enable Javascript and refresh this page.