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.
GET
xml, json
xml, json
https://api.globalgiving.org/api/public/projectservice/themes/projects/ids
&api_key described in the API Key section, required
/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
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 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.
themes |
|
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. |