The GlobalGiving API is RESTful in nature and requires users to construct Uniform Resource Identifiers (URIs) that will return the data requested in the format indicated.
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:
https://api.globalgiving.org/api/public/projectservice/themes?api_key=658137f6-ecaa-4587-8701-cc692cb9b153
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.
https://api.globalgiving.org/api/public/projectservice/themes?api_key=658137f6-ecaa-4587-8701-cc692cb9b153
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'.
Similarly, when posting data, such as when accessing the Get Access Token or Submitting a Donation operations, the format in which the data is sent can be specified using the Content header.
Request data may be sent as XML 'Content-Type: application/xml' or JSON 'Content-Type: application/json'.
Please read the Code of Conduct, and the Terms of Service, then register here to get your API key.
