As an example, try out the Get Themes API Operation which returns all GlobalGiving themes, under which projects are categorized, by accessing the following URL:
Evaluating All the Pieces
In the example above, the first thing you should notice is GlobalGiving API operations use the HTTPS protocol. This ensures all sensitive data, such as when submitting a donation or order, is transmitted securely.
API Production and Test Domains
All API operations are available using the api.globalgiving.org domain.
GlobalGiving Resource URIs
GlobalGiving resources are accessed using URIs. All available API operations can be accessed here.
Query String Parameters
Almost all API operations require at a minimum an api_key query string parameter. The one exception is the Get Access Token operation where the api_key, instead, is embedded in the posted XML or JSON data.
Query string parameters make up part of the URL and contains data the GlobalGiving API operation is expecting and will process.
When accessing the above example URL in a browser, the results are returned in the default XML format since the response type was not specified. To change the response format to JSON a client such as cURL, where the Accept header can be specified, must be used.
Responses may be formatted as XML 'Accept: application/xml' or JSON 'Accept: application/json'.
Request data may be sent as XML 'Content-Type: application/xml' or JSON 'Content-Type: application/json'.
Ready to get started?