Donations API: List, Record, and Filter Gift Records

The Donations API connects to the Fundraising workspace, where every gift your organization receives lives alongside the donor who gave it, the campaign it supports, and optionally the animal that inspired it. Use this API to pull donation history into external reporting tools, sync gifts recorded elsewhere into RescueConsole, or build custom fundraising dashboards that read live data from your rescue.

Donations recorded through the API are created with the paymentMethod you specify in the request body. They do not flow through Stripe or any other payment processor — no money moves, and no payment is initiated. If you need a donor to pay online, use the payment link flow in the app or the Stripe integration. Use the API to record gifts that have already been collected (cash, check, or an external processor) so your ledger stays complete.

List Donations

Retrieve a paginated list of donation records. Use filters to narrow by donor, campaign, date, or donation type.

GET /donations

Query Parameters

integer

default:"1"

Page number to retrieve.

integer

default:"25"

Number of records per page. Maximum 100.

string

Filter to donations from a specific person record. Pass the person’s ID.

string

Filter to donations attributed to a specific campaign.

string

Filter by donation type. One of one-off, recurring, or post-adoption.

string

Return only donations on or after this date. Format: YYYY-MM-DD.

string

Return only donations on or before this date. Format: YYYY-MM-DD.

string

Filter to donations attributed to a specific animal record.

Example Request

curl -X GET "https://your-org.rescueconsole.com/api/v1/donations?type=one-off&dateFrom=2026-09-01&dateTo=2026-09-30" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "don_01hz7p4nqr8vcd2kef3ab5wx",
      "donorId": "pers_01hy2a4bnq7c9wd3km8ex5rp",
      "amount": 50.00,
      "currency": "USD",
      "type": "one-off",
      "campaignId": "camp_01hw9z1kqp2f8vbn3tj7yd5m",
      "animalId": "anim_01hx9z3kqp4f8vbn2tj7yd6m",
      "paymentMethod": "card",
      "gateway": "stripe",
      "gatewayTransactionId": "ch_3NkLmP2eZvKYlo2C0abc1234",
      "date": "2026-09-14",
      "notes": null,
      "createdAt": "2026-09-14T15:30:00Z"
    }
  ],
  "meta": {
    "total": 67,
    "page": 1,
    "perPage": 25,
    "totalPages": 3
  }
}

Retrieve a Donation

Fetch the full record for a single donation by ID.

GET /donations/{id}

Path Parameters

string

required

The unique ID of the donation record.

Example Request

curl -X GET "https://your-org.rescueconsole.com/api/v1/donations/don_01hz7p4nqr8vcd2kef3ab5wx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Fields

string

The unique identifier for this donation record.

string

The ID of the person record for the donor.

number

Gift amount as a decimal number (e.g. 50.00).

string

Three-letter ISO 4217 currency code (e.g. USD, CAD).

string

The donation type. One of one-off (a single gift), recurring (a pledge on a schedule), or post-adoption (an additional gift made at adoption checkout).

string

The ID of the campaign this donation is attributed to. May be null if the gift is not tied to a campaign.

string

The ID of the animal this donation is attributed to. May be null.

string

How the gift was paid. Common values: card, cash, check, bank_transfer, other.

string

The payment processor used, if any. Common values: stripe, square, zeffy, paypal. May be null for cash or check gifts.

string

The transaction ID from the payment processor. Use this for reconciliation. May be null.

string (date)

The date the gift was made, in YYYY-MM-DD format.

string

Internal notes about this donation. May be null.

string (ISO 8601)

Timestamp when the record was created in RescueConsole.

Record a Donation

Create a new donation record. Use this to log gifts collected outside of RescueConsole — cash, check, or an external payment processor.

POST /donations

Request Body

string

required

The ID of the person record for the donor. The person must already exist in RescueConsole.

number

required

Gift amount as a decimal number (e.g. 25.00). Must be greater than 0.

string

default:"USD"

Three-letter ISO 4217 currency code. Defaults to your organization’s configured currency if omitted.

string

required

Donation type. One of one-off, recurring, or post-adoption.

string

required

The date the gift was made, in YYYY-MM-DD format.

string

required

How the gift was paid. Use card, cash, check, bank_transfer, or other.

string

The ID of the campaign to attribute this gift to. Omit if the gift is not tied to a campaign.

string

The ID of the animal to attribute this gift to. Omit if not applicable.

string

The payment processor used, if any. For example, stripe, square, zeffy, paypal. Omit for cash or check gifts.

string

The transaction ID from your payment processor. Include this to support reconciliation.

string

Internal notes to attach to this donation record.

Example Request

curl -X POST "https://your-org.rescueconsole.com/api/v1/donations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "donorId": "pers_01hy2a4bnq7c9wd3km8ex5rp",
    "amount": 100.00,
    "currency": "USD",
    "type": "one-off",
    "date": "2026-09-17",
    "paymentMethod": "check",
    "campaignId": "camp_01hw9z1kqp2f8vbn3tj7yd5m",
    "notes": "Check #1042 received at adoption event."
  }'

Response

Returns 201 Created with the full donation record as the response body.

Donation Types Reference

one-off

A single gift with no recurrence. The most common type. Use this for cash, check, one-time card gifts processed outside Stripe, and any gift that does not repeat on a schedule.

recurring

A gift on a repeating schedule — monthly, quarterly, or annually. Recording a recurring donation via the API creates a single instance; it does not automatically generate future records. Log each installment separately as it is received.

post-adoption

An additional voluntary contribution made at the time of an adoption. Adoption fee transactions processed through Stripe’s payment link flow are created automatically — use this type only when recording a post-adoption gift collected outside the payment link.

Overview

Resources

Donations API: List, Record, and Filter Gift Records

List Donations

Query Parameters

Example Request

Response

Retrieve a Donation

Path Parameters

Example Request

Response Fields

Record a Donation

Request Body

Example Request

Response

Donation Types Reference

​List Donations

​Query Parameters

​Example Request

​Response

​Retrieve a Donation

​Path Parameters

​Example Request

​Response Fields

​Record a Donation

​Request Body

​Example Request

​Response

​Donation Types Reference

List Donations

Query Parameters

Example Request

Response

Retrieve a Donation

Path Parameters

Example Request

Response Fields

Record a Donation

Request Body

Example Request

Response

Donation Types Reference