> This page is for version v2026-04-01 (default).
> For other versions, use one of these documentation indexes:
> - v2026-04-01 (default): https://docs.givechariot.com/v2026-04-01/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.givechariot.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.givechariot.com/_mcp/server.

# Donation Status

A Donation's `payment_status` tells you where the money is, regardless of how the gift was initiated.

| Value                      | What it means                                                                                                                                                                                                                                                                         |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INCOMING_TO_CHARIOT`      | The funds are on their way into your Chariot account. Chariot usually matches them automatically and marks the gift `RECEIVED_IN_CHARIOT` once the deposit completes; a deposit Chariot cannot match is reconciled in the dashboard. Chariot emails you once the funds are available. |
| `INCOMING_OUTSIDE_CHARIOT` | The funds are on their way to you directly from the payer, so Chariot cannot see them land. Someone on your team marks the gift received in the dashboard, unless a connected source records the payment first.                                                                       |
| `RECEIVED_IN_CHARIOT`      | The funds arrived in your Chariot account.                                                                                                                                                                                                                                            |
| `RECEIVED_OUTSIDE_CHARIOT` | Receipt was confirmed outside Chariot, by you or by a connected source.                                                                                                                                                                                                               |
| `CANCELED`                 | The gift will not be paid.                                                                                                                                                                                                                                                            |

Payment status is derived by Chariot from the state of the funds, so it is read only over the API.

## Settlement Timestamps

A Donation can read as received before the money is usable. Check the timestamps when your workflow depends on funds being available.

| Field                   | What it marks                             |
| ----------------------- | ----------------------------------------- |
| `created_at`            | When Chariot created the Donation record. |
| `settlement.settled_at` | When the deposit settled at the bank.     |
| `settlement.deposit_id` | The Deposit the funds arrived in.         |

## Retrieving Donations

[Getting Started](/guides/processing/getting-started#step-3-retrieve-donations) shows the List Donations and Get Donation calls. List Donations returns gifts across every connected payment source on the account, pages with `next_page_token`, which you pass back as `page_token` with the same filters, and caps the page size at 100. You can filter by `payment_source_id`, `deposit_id`, `created_at.after`, `created_at.before`, and `dafpay_tracking_id`.

> **Filtered by Creation Date**
>
> List Donations filters on `created_at`, not `updated_at`, so it will not show changes to older gifts. Pair it with `donation.updated` events.

## Recording Your Own Status

Properties are the writable part of a Donation, and you retrieve them alongside the rest of the Donation data. To record your own status, for example that a gift has been entered in your CRM, create a property in the Chariot Dashboard and assign it to the Donation. The [FAQ](/guides/processing/faq#how-do-i-add-custom-fields-to-donations) shows the call.