Improve your Skyline experience
You're using a browser that skyline.benevity.org does not support. Try Chrome, Edge, Safari or Firefox for a better experience.

# Releases

# Schedule

# Production

  • Our production releases will be under the api.benevity.org domain.
  • We currently have ~99.9% uptime on Production, excluding allotted downtime.
  • We take our Platform offline for a few hours on a Saturday night (6:00PM - 12:00am MT), every ~5 weeks for scheduled maintenance. Our Platform is typically down for less than half of the 6h maintenance window.

# Sandbox

  • Our sandbox releases will be under the api.benevity-staging.org domain.
  • We target ~99.9% uptime on Sandbox 9:00am - 5:00pm MT, Monday to Friday.
  • We take our Sandbox environment offline during the same maintenance windows as our Production environment.

# Scheduled downtime

Release Version Date
2023.8 30 September 2023
2023.9 4 November 2023
2023.10 9 December 2023
2024.1 27 January 2024
2024.2 9 March 2024
2024.3 27 April 2024
2024.4 8 June 2024
2024.5 27 July 2024
2024.6 7 September 2024
2024.7 2 November 2024
2024.8 14 December 2024

Unscheduled downtime (opens new window)

# Status page

You can subscribe to the latest updates on our products availability at Benevity Status Page (opens new window).

# Changelog

# 2024-07-11

Updated

  • Cause Accounts: Added the list of available accounts and payment types a cause could be disbursed in, such as EFT, CHEQUE, PAYPAL

# 2024-07-08

Updated

  • Giving - Post Paid Donations: Added payable object with paymentType attribute (CHEQUE/EFT/PAYPAL) to GET /donations and GET /donations/:id responses

# 2024-04-16

Updated

  • Giving API: Clarified how the sharing attribute behaves in the payments API specification & prepaid donations guide.

# 2024-03-26

Updated

  • Giving - Post Paid Donations: Added the ability to donate to Portfolios by specifying a portfolio ID as the recipientId

# 2023-10-30

Updated

  • Release Date Updates: Added the 8 scheduled release dates for 2024

# 2023-06-07

Changed

  • Giving - Post Paid Donations: Updated documentation and schema file to include newly supported donation status codes

# 2023-02-24

Changed

  • API Reference - Supported Currencies: Updated foundation name for German foundation (HdS)

# 2022-12-16

Changed

  • Search: Removed Postman links for volops and giveops guides as they are discontinued

# 2022-11-18

Features

  • Cause Search: GET /autocomplete/causes supports type ahead autocomplete to have results returned as someone is searching for a cause

# 2022-11-14

Changed

  • Giving API: Updated metadata constraints on post-paid donations

# 2022-11-11

Changed

  • Cause Search: Updated contact and location parameter descriptions

# 2022-11-09

Changed

  • Giving API: Updated wording and attributes for credit card donation guide
  • Concepts and References: Added section on Foundation Partners to concepts and references page
  • Releases: Updates to 2023 release schedule

# 2022-10-28

Features

  • Giving API: Added metadata attribute support for post-paid company donations

# 2022-10-20

Features

  • Causes - Get Cause Details: Added categories, tags, certification, and owner-verified attributes to GET /causes/:id response

# 2022-10-19

Changed

  • Concepts and References: Added Concepts and References page with descriptions of Gift Aid and 3-D Secure
  • Request/Response Samples: Ellipsized test tokens in sample requests to improve readability

# 2022-09-27

Changed

  • Authorization: Updated auth guide to pass parameters into the form body

# 2022-09-22

Features

  • Location Services API: Added guides and API reference for Location Services API

# 2022-09-06

Changed

  • Authorization: Updated auth guide with best practices for token reuse based on expiry

# 2022-05-16

Changed

  • Authorization: Updated auth guide and reference with error messaging

# 2022-04-19

Changed

  • API Reference: Updated Supported Currencies section to show foundations associated with each currency

# 2022-03-17

Changed

  • API Reference: Updated API Errors section with Payments API errors

# 2022-02-14

Changed

  • Releases: Updates to 2022 release dates

# 2022-02-03

Changed

  • Request/Response Samples: Replaced jQuery ajax examples with node-fetch

# 2022-01-31

Changed

  • Giving API: Fixed parameter ordering in Post-Paid Bulk Donation guide

# 2021-12-07

Features

  • Causes - Get Cause Details: GET /causes/:id supports obtaining additional details about a cause

# 2021-11-17

Changed

  • Search Causes: Updated cause search/autocomplete spec and snippets in guide

# 2021-09-22

Features

  • Giving API: GET /donations supports cursor based pagination and filtering by bulk id and donation status

# 2021-08-20

Features

  • Giving API: Make Bulk Company Donations section added for post-paid donations with the ability to create thousands of donations using file upload

# 2021-06-15

Features

  • Giving API: Added a guide on how to make invoiced donations
  • Giving API: Added a guide on common reasons for donation failures and how to avoid them

# 2021-06-01

Changed

  • Overview section: The overview section of the site has been updated.
  • Request/Response Samples: Requests and response samples have been updated to display test tokens only

# 2021-05-04

Features

  • Giving API & Search API: All the Giving and Search APIs now have code samples in multiple languages alongside curl requests.

# 2021-04-08

Features

  • Giving API: Added payments API to ping the backend via /payments/ping

Changed

  • Giving API: Noted all payments endpoints as secured via OAuth2

# 2021-04-06

Features

  • Open API Spec - Cause Search Autocomplete: Adds the new cause search autocomplete to the open API spec.

Changed

  • Giving API: Separates cause search and authorization out of the giving API guide into their own sections.
  • Open API Spec: Updated Giving API payment endpoints, the new endpoints offer a simplified way to make a donation.
  • General Site Updates: Copy (Text) Corrections and Language Enhancements for Clarity.

# 2020-12-23

Features

  • Giving API: Adds a giving API guide, the guide covers searching for a cause, making a donation and getting a receipt.
  • Search: Adds a search functionality to the site, this will allow you to search the headers of content in the site.
  • Benevity Overview: Enhanced description of donation flow.

# 2020-07-03

Changed

  • Postman Collection: Postman collections have been updated to reflect the new benevity/api scope. If you  were previously using the Postman collection, you will have to re-download it in order to try out the endpoints.

# 2020-04-18

Features

  • Search Cause endpoint: Open API compliant endpoint for searching Causes and Projects by term.