API reference · Recurring Donations
List recurring donations
GET/v1/recurring-donations
List all your recurring donations.
Requires a Bearer access token.
Parameters
limit#numberin queryThe max number of items to return.
cursor#stringin queryThe id of the last item from the previous page. Used to fetch the next page.
createdAt_lt#string (date-time)in queryFormat: YYYY-MM-DDTHH:MM:SSZ.
createdAt_lte#string (date-time)in queryFormat: YYYY-MM-DDTHH:MM:SSZ.
createdAt_gt#string (date-time)in queryFormat: YYYY-MM-DDTHH:MM:SSZ.
createdAt_gte#string (date-time)in queryFormat: YYYY-MM-DDTHH:MM:SSZ.
campaignId#stringin queryUUIDId of one your campaigns
status#stringin queryStatus of your recurring donations
PENDINGACTIVEPAUSEDCANCELEDdonorId#stringin queryUUIDId of the donor.
includeMetrics#booleanin queryInclude metrics
includeCharity#booleanin queryInclude charity
Required in the spec, optional for the API.
accountId#stringin queryUUIDId of the account. Only useful for Platform customers to filter recurring donations by child accounts.
Response
200 · RecurringDonationWithMetrics[]No field is described in the spec.
recurringDonationId#stringalways returnedtype#RecurringDonationTypealways returnedFREQUENCYMANUALamountType#RecurringDonationAmountTypealways returnedFIXED_AMOUNTRATEstatus#RecurringDonationStatusalways returnedPENDINGACTIVEPAUSEDCANCELEDhasBeenCharged#booleanalways returnedfeeType#FeeTypealways returnedEXCLUDEDINCLUDEDamount#integer (int64)always returnedrate#numberbaseAmount#integer (int64)withRounding#booleanalways returnedfrequency#stringsecret#stringalways returnedexternalId#stringuniqueExternalId#stringsendingMode#CampaignSendingModealways returnedMANUALEMAILPHYSICALSLACKPOSTALsendingDate#string (date-time)sendingStatus#DonationSendingStatusalways returnedPENDINGFAILEDDONElastReminderId#stringmessage#stringreminderMessage#stringfrom#stringlanguage#Languagealways returnedfrenaccountId#stringalways returnedcampaignId#stringalways returnedcharityId#stringdonorId#stringalways returnedcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returned
Errors
400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }
curl -X GET https://api.sandbox.charitips.com/v1/recurring-donations \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.