The Donation Object

idstringRequiredRead-only

The unique identifier for the donation in Chariot's system.

amount_grosslongRequired

The total amount of the donation in minor units of the currency. For dollars, for example, this is cents.

amount_netlongRequired

The amount of the donation that the nonprofit will receive after processing fees are deducted in minor units of the currency. For dollars, for example, this is cents.

amount_feelongRequired

The amount of the fee that was deducted from the donation in minor units of the currency. For dollars, for example, this is cents.

currencystringRequired

The ISO 4217 code for every amount on the donation. Defaults to USD unless the source reports another currency.

created_atdatetimeRequiredRead-only

The date and time the donation record was created in Chariot.

external_idstringOptional

The identifier for the donation as reported by its source, such as the transaction ID. Use it to reconcile the donation in Chariot against the original source donation record.

source_idstringOptional

The identifier of the Source that sent this donation.

individual_gift_amountlong or nullOptional

The portion of the gross amount contributed directly by the donor.

exchange_rateobject or nullOptional

The exchange rate used to convert the donation into target_currency. Null when currency is already the target currency, or when no rate was reported.

donation_typeenum or nullOptional

The kind of gift.

individual: a gift from an individual donor.
match: a company's match of an employee's gift.
daf: a grant from a donor-advised fund.
other: any other kind of gift.

Allowed values:

frequencyenum or nullOptional

Whether the donor set the gift to repeat. Null when the source didn't report it.

Allowed values:

effective_datedatetimeOptional

The date of the donation, as reported by the source. Expressed in RFC 3339 format.

grantorobjectOptional

The entity responsible for issuing a grant or payment to a recipient.

created_byobjectOptional

Who created the donation.

external_distribution_idstringOptional

The platform's identifier for the payout that carried this donation. Platforms such as Benevity batch many donations into one payout, so several donations can share the same value.

recipientobjectOptional

The nonprofit the donation was made out to, as named by the source.

purposestringOptional

A description of the donor's intent for the donation. This is useful to understand how the donor intended the donation to be used. For example, "Where needed most" or "General Operating Support" or "Specific Campaign".

notestringOptional

An informational note from the donor to the nonprofit about the donation. This may contain a message or other useful information that the donor wants to share with the nonprofit.

attributionobjectOptional

How the donation is attributed to a donor.

initiationobjectOptional

How and where the donor initiated the gift.

settlementobjectOptional

How the funds are moving from the donor to the recipient.

donor_advised_fund_grantobjectOptional

Details specific to Donor Advised Fund donations. Empty when the donation did not come from a DAF provider.

metadatamap from strings to anyOptional

Arbitrary key-value pairs recorded against the donation. Use this for reconciliation data, campaign identifiers, or other integration data.

corporate_matchobjectOptional

Details specific to matched donations. Empty when no corporate sponsor matched the donation.

propertieslist of objectsOptional

A list of custom properties for the donation.

artifactslist of objectsOptional

A list of source artifacts that were used to create the donation. These can include the raw source files (PDFs, CSVs, etc.) that were received from upstream platforms or systems.

linked_objectslist of objectsOptionalRead-only

Other objects connected to this donation, such as the Grant or Mail Item that produced it. Each entry names the object's type and identifier; fetch the object itself for its details.

updated_atdatetimeOptionalRead-only

The date and time when the donation was last updated.

canceled_atdatetime or nullOptionalRead-only

When the donation was canceled. If set, the donor's payment did not complete and the recipient did not receive the gift. Expressed in RFC 3339 format.

payment_statusenumOptionalRead-only

The payment status of the donation. Indicates the current state of the payment lifecycle.

Allowed values:

payment_source_idstringOptionalDeprecated

Deprecated. Use source_id.

platformobjectOptionalDeprecated

Deprecated. Information about the platform that facilitated the donation. Empty when no platform facilitated the donation.

{
  "id": "donation_01j8rs605a4gctmbm58d87mvsj",
  "amount_gross": 25000,
  "amount_net": 25000,
  "amount_fee": 0,
  "currency": "USD",
  "created_at": "2026-09-25T14:00:00Z",
  "external_id": "INV-12345",
  "source_id": "source_01m12tn300eh20gdqscje7s5jw",
  "individual_gift_amount": 25000,
  "donation_type": "daf",
  "frequency": "one_time",
  "effective_date": "2026-09-24T00:00:00Z",
  "grantor": {
    "organization_name": "Fidelity Charitable"
  },
  "created_by": {
    "name": "Fidelity Charitable"
  },
  "purpose": "Where needed most",
  "note": "Please dedicate in memory of grandma",
  "attribution": {
    "primary_donor": {
      "full_name": "Jane Rivera",
      "first_name": "Jane",
      "last_name": "Rivera",
      "email": "jrivera@example.com",
      "phone": "415-555-1212",
      "address": {
        "city": "New York",
        "country": "US",
        "line1": "123 Main St.",
        "postal_code": "10001",
        "state": "NY"
      }
    }
  },
  "initiation": {
    "initiated_at": "2026-09-20T15:04:05Z",
    "amount_initiated": 25000,
    "channel": "INTEGRATED",
    "web_location_url": "https://givebutter.com/example-nonprofit",
    "dafpay_tracking_id": "L9E182VBGP",
    "form": "Givebutter",
    "identifier": "L9E182VBGP",
    "metadata": {
      "campaign_id": "spring-appeal"
    }
  },
  "settlement": {
    "type": "chariot",
    "received_at": "2026-09-25T14:00:00Z",
    "settled_at": "2026-09-25T18:00:00Z",
    "deposit_id": "deposit_01j8rs605a4gctmbm58d87mvsj"
  },
  "donor_advised_fund_grant": {
    "donor_fund_name": "The Rivera Family Fund"
  },
  "metadata": {
    "crm_id": "0035e00000ABCDE"
  },
  "properties": [
    {
      "property_id": "prop_01j8rs605a4gctmbm58d87mvsj",
      "value": {
        "type": "text",
        "text_value": "Fall Gala"
      }
    }
  ],
  "artifacts": [
    {
      "name": "grant_letter.pdf",
      "file_id": "file_01j8rs605a4gctmbm58d87mvsj",
      "created_at": "2026-09-25T14:00:00Z"
    }
  ],
  "linked_objects": [
    {
      "type": "mail_item",
      "id": "mail_item_01j8rs605a4gctmbm58d87mvsj"
    }
  ],
  "updated_at": "2026-09-25T18:00:00Z",
  "canceled_at": null,
  "payment_status": "RECEIVED_IN_CHARIOT",
  "payment_source_id": "payment_source_01m12tn300eh20gdqscje7s5jw"
}