Endpoints

Make API calls to Donorbox

Each HTTP request consists of an HTTP Method and an endpoint. Throughout the documentation, these requests are formatted like the following example.

{METHOD} https://donorbox.org/{endpoint}

All the API calls will need a basic authentication, you need to send a username which is your organization email and a password which is your API KEY.

Campaigns

Get information for all your campaigns.

{GET} https://donorbox.org/api/v1/campaigns

Output:

[
  {
    "id":1,
    "name":"Donorbox New Campaign",
    "slug":"donorbox-new-campaign",
    "currency":"usd",
    "created_at":"2017-10-20T22:30:55.620Z",
    "updated_at":"2017-10-20T22:30:55.620Z",
    "goal_amt":"10000.0",
    "formatted_goal_amount":"$1,0000",
    "total_raised":"2000.0",
    "formatted_total_raised":"$2000",
    "donations_count":66
  }
]

Donations

Get all your organization's donations.

{GET} https://donorbox.org/api/v1/donations

Output:

[ 
  {
    "campaign": {
        "id": 1,
        "name": "Donorbox Campaign"
    },
    "donor": {
        "id": 59,
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoeemail@hotmail.com",
        "address":"123 6th St. Melbourne, FL 32904",
        "city":"Melbourne",
        "state":"FL",
        "zip_code": "32904",
        "country":"USA",
        "employer":null,
        "occupation":null
    },
    "amount": "100.0",
    "formatted_amount": "$100",
    "converted_amount": "100.0",
    "formatted_converted_amount": "$100",
    "recurring": false,
    "first_recurring_donation": false,
    "amount_refunded": "0.0",
    "formatted_amount_refunded": "$0",
    "stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
    "id": 1,
    "status": "paid",
    "donation_type": "stripe",
    "donati[ 
  {
    "campaign": {
        "id": 1,
        "name": "Donorbox Campaign"
    },
    "donor": {
        "id": 59,
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoeemail@hotmail.com",
        "address":"123 6th St. Melbourne, FL 32904",
        "city":"Melbourne",
        "state":"FL",
        "zip_code": "32904",
        "country":"USA",
        "employer":null,
        "occupation":null
    },
    "amount": "100.0",
    "formatted_amount": "$100",
    "converted_amount": "100.0",
    "formatted_converted_amount": "$100",
    "recurring": false,
    "first_recurring_donation": false,
    "amount_refunded": "0.0",
    "formatted_amount_refunded": "$0",
    "stripe_charge_id": "ch_1BF94aBku99FiTp3uJM5mSKw",
    "id": 1,
    "status": "paid",
    "donation_type": "stripe",
    "donation_date": "2017-12-21T17:54:13.432Z",
    "anonymous_donation": false,
    "gift_aid": false,
    "comment": "thanks",
    "donating_company": null,
    "currency": "USD",
    "converted_currency": "USD",
    "processing_fee": 0.59,
    "formatted_processing_fee": "$0.59",
    "questions": [
        {
          "question_type": "radiobutton",
          "question": "Would you like to volunteer?",
          "answer": "Yes"
        },
        {
          "question_type": "text",
          "question": "Why are you donating",
          "answer": "I would like to help"
         },
         {
          "question_type": "check",
          "question": "First/Last Name is correct?",
          "answer": true
         },
         {
          "question_type": "dropdown",
          "question": "Would you like to showcase your donation",
          "answer": "Yes"
         }
    ]
  }
]

Donors

Get information for all your donors.

{GET} https://donorbox.org/api/v1/donors

Output:

[
  {
    "id":35,
    "created_at":"2017-11-20T14:01:35.597Z",
    "updated_at":"2017-11-28T21:49:25.127Z",
    "first_name":"John",
    "last_name":"Doe",
    "email":"johndoe@email.com",
    "phone":"123456789",
    "address":"123 6th St. Melbourne, FL 32904",
    "city":"Melbourne",
    "state":"FL",
    "zip_code":"32904",
    "country":"USA",
    "employer":null,
    "occupation":null,
    "comment":null,
    "donations_count":2,
    "last_donation_at":"2017-11-28T21:48:51.260Z",
    "total":[
      {
        "currency":"usd",
        "value":100.0
      }
    ]
  }
]