Learn how to navigate the resources provided by the Giveabl REST API.
Giveabl's APIs (Application Programming Interfaces) power its donation platform. Behind these APIs is a software layer connecting charities, NPOs and social enterprises, along with Charitable Funds and Foundations, to facilitate automated donations globally.
What is an API?
API is short for 'Application Programming Interface'. It is a set of rules that allow computer programs to communicate with each other. An API defines the way the program will communicate, what data will be exchanged, and how the data will be formatted.
All Giveabl REST API access is over HTTPS, and accessed from:
The API is organized around REST. REST stands for 'Representational State Transfer'. Web services that conform to the REST architectural pattern are generally APIs that are accessed using the HTTP protocol at a predefined set of URLs.
These URLs respresent various resource objects, typically returned as JSON. Often, resources have methods that can be performed over HTTP, like
DELETE. Giveabl's API uses
POSTto create new resource objects, and
PATCHto update existing resource objects.
Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
Where possible, the Giveabl REST API strives to use appropriate HTTP verbs for each action.
Used for retrieving resources.
Used for creating resources.
Used for updating resources with partial JSON data. For instance, an Fundraiser resource has title and excerpt attributes. A PATCH request may accept one or more of the attributes to update the resource.
Used for replacing resources or collections. For PUT requests with no body attribute, be sure to set the Content-Length header to zero.
Used for deleting resources.
Create a :resource
Retrieve a :resource
Retrieve all :resources
Update a :resource
:action a :resource
Delete a :resource
Responses are returned in a consistent, standard format that includes a
dataproperty and a
Returning a single result (object):
Returning a list of results (
datais an array of objects,
You can use the Giveabl API in test mode, which does not affect your live data or interact with payment processing networks. The API Key you use to authenticate the request determines whether the request is live mode or test mode.