Quick Start

Generate an access token 🔑

First, you’ll need to create an access token that lets you access the APIs. Fill in the provided client_id and client_secret to in the preferred code snippet and get an access token.

1
curl --request POST \
2
  --url 'https://chariot-sandbox.us.auth0.com/oauth/token' \
3
  --header 'content-type: application/x-www-form-urlencoded' \
4
  --data 'audience=https://api.givechariot.com&grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET'

Now that you have an access token, you’re set to initiate an API request. We’re going to utilize Chariot’s APIs to generate a CID (Connect Identifier) for a nonprofit organization. This CID is a crucial element needed to activate the DAFpay button.

To create a CID to a nonprofit, we first establish the nonprofit’s ID by utilizing their EIN (Employer Identification Number). Following that, we proceed to create a Connect with the nonprofit’s ID.

Create Nonprofit 🏥

The Create nonprofit endpoint registers a new nonprofit or confirms its existence within the Chariot system.

For registration, it’s necessary to supply the nonprofit’s EIN and details for a contact person at the nonprofit for Chariot’s customer support purposes.

Below are a few examples of different implementations. Modify the user object, ein field, and access token from step 1 before making the request.

1
curl --request POST \
2
     --url https://sandboxapi.givechariot.com/v1/nonprofits \
3
     --header 'accept: application/json' \
4
     --header 'authorization: Bearer ACCESS_TOKEN' \
5
     --header 'content-type: application/json' \
6
     --data '
7
{
8
     "user": {
9
          "email": "hansolo@savethestars.com",
10
          "phone": "3051234321",
11
          "firstName": "Han",
12
          "lastName": "Solo"
13
     },
14
     "ein": "123456789"
15
}
16
'

Bravo! You have just created a nonprofit in the Chariot system. Mark down the nonprofit’s id and now let’s create a Connect for this nonprofit.

Create Connect 🪪

The Create Connect endpoint creates a Connect record or retrieves it if a Connect already exists for this nonprofit in Chariot’s system.

To create a Connect, the nonprofit’s id must be provided, which you should have from the previous step!

Below are a few examples of different implementations. Modify the NONPROFIT_ID query parameter with the nonprofit’s id. Don’t forget to add the access_token!

1
curl --request POST \
2
     --url 'https://sandboxapi.givechariot.com/v1/connects?nonprofit=NONPROFIT_ID' \
3
     --header 'accept: application/json' \
4
     --header 'authorization: Bearer ACCESS_TOKEN' \
5
     --header 'content-type: application/json'

Amazing! You can now start Integrating DAFpay to build a front end and start receiving grants for this nonprofit.

List Grants 💵

After submitting several grants through Chariot Connect, you can access Chariot’s APIs to retrieve information on those grants.

The List Grants endpoint lists all the grants for a particular CID.

To retrieve grants, you must supply the API key of the Connect. You can obtain the API Key by using the Get Connect endpoint or by noting it down from the setup process when you initially created the Connect.

Now we are ready to list grants. Below are a few examples of different implementations. Modify the API_KEY with the Connect’s API key. Don’t forget to add the access_token!

1
curl --request GET \
2
     --url 'https://sandboxapi.givechariot.com/v1/grants?pageLimit=10' \
3
     --header 'accept: application/json' \
4
     --header 'authorization: Bearer ACCESS_TOKEN' \
5
     --header 'x-chariot-api-key: API_KEY'