Sign in

v31

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-215985245.8 KB
disbursements

Create a disbursement

Create a disbursement to send money to an organization.

post/v1/disbursements

Request body

organization_idstring required

The ID of the organization that will receive the disbursement.

program_idstring nullable

The identifier for the program that the disbursement is associated with. The program must have grant_disbursement_status enabled. If not provided, your grant_disbursement_status enabled program will be used. If your Chariot account has multiple grant_disbursement_status enabled programs, you must specify the program_id to use for the disbursement.

amountinteger required

The disbursement amount in USD cents. Must be a positive amount.

auto_fundboolean

Enable just-in-time (JIT) funding for this disbursement. When true, Chariot will automatically create an inbound transfer for the disbursement amount when it is approved, eliminating the need to pre-fund your account. This feature must be enabled on your account. Contact Chariot to enable JIT disbursements.

bypass_chariot_organization_verificationboolean

By default (false), the disbursement will remain in the awaiting_verification status until Chariot's compliance team has verified the nonprofit. If set to true, the disbursement will proceed through its normal lifecycle without waiting for Chariot to verify the organization. Only set this if you have independently verified the organization and do not want to wait for or rely on Chariot's verification. This field is only relevant when disbursing to an organization that was created via a verification request.

Example request

{
  "organization_id": "org_1234567890",
  "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
  "amount": 10000,
  "transactions": [
    {
      "amount": 10000,
      "fee_amount": 500,
      "description": "Donation to nonprofit",
      "donor_advised_fund_grant": {
        "grant_id": "grant_1234567890",
        "organization_name": "Vanguard Charitable",
        "fund_name": "John Doe Fund",
        "purpose": "General Operating Support",
        "note": "This grant is for the general operating support of the organization.",
        "donors": [
          {
            "full_name": "John Doe",
            "first_name": "John",
            "last_name": "Doe",
            "email": "bob@me.com",
            "phone": "415-555-1212",
            "address": {
              "city": "New York",
              "country": "US",
              "line1": "123 Main St.",
              "postal_code": "12345",
              "state": "NY"
            }
          }
        ]
      }
    }
  ]
}

Response

The disbursement was created

idstring required

The unique identifier for the disbursement

organization_idstring required

The unique identifier for the organization that will receive the payment

program_idstring required

The unique identifier for the program that the disbursement belongs to

amountinteger required

The payment amount in USD cents. Must be a positive amount.

descriptionstring

A description for the disbursement

auto_fundboolean

Whether just-in-time (JIT) funding is enabled for this disbursement. When true, Chariot automatically creates an inbound transfer for the disbursement amount when it is approved.

created_atstring date-time

The date and time the disbursement was created

updated_atstring date-time

The date and time the disbursement was last updated

status'pending_approval' | 'canceled' | 'awaiting_verification' | 'rejected' | 'validating_organization' | 'awaiting_account_claim' | 'awaiting_balance' | 'submitted' | 'stopped' | 'completed' | 'failed'

The lifecycle status of the disbursement. Possible values include:

  • pending_approval: The disbursement is awaiting approval from the grantmaker
  • canceled: The disbursement was canceled by the grantmaker
  • awaiting_verification: The disbursement is awaiting verification from Chariot
  • rejected: The disbursement was rejected by Chariot before being submitted
  • validating_organization: Validating recipient organization's payment and contact information before submission.
  • awaiting_account_claim: The disbursement is awaiting account claim by the nonprofit or check delay expiration
  • awaiting_balance: The disbursement is awaiting sufficient grantmaker balance
  • submitted: The disbursement payment has been submitted to the payment network and is being processed
  • stopped: The disbursement payment was stopped after it was submitted
  • completed: The disbursement payment has been completed and funds have been received by the receiving organization
  • failed: The disbursement payment failed or the receiving organization did not receive the payment

To see a description of each status, see the "Disbursement Lifecycle" section of the Chariot documentation.

Example response

{
  "id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
  "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
  "organization": {
    "id": "org_01j8rs605a4gctmbm58d87mvsj",
    "ein": "123456789",
    "name": "American Red Cross",
    "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
    "physical_address": {
      "city": "New York",
      "country": "US",
      "line1": "123 Main St.",
      "postal_code": "12345",
      "state": "NY"
    },
    "classification": {
      "subsection_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "filing_requirement_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "foundation_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "affiliation_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "organization_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "exempt_status_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "deductibility_code": {
        "code": 1,
        "name": "UNCONDITIONAL",
        "description": "Unconditional Exemption"
      },
      "ntee_code": {
        "code": "A",
        "description": "Animal Welfare",
        "parent_code": "A",
        "parent_description": "Animal Welfare"
      },
      "naics_code": {
        "naics2": "31",
        "naics2_description": "Manufacturing",
        "naics4": "3112",
        "naics4_description": "Grain and Oilseed Milling",
        "naics6": "311221",
        "naics6_description": "Wet Corn Milling and Starch Manufacturing"
      }
    },
    "compliance": {
      "daf_eligible": true,
      "irs_pub_78": {
        "compliant": true,
        "last_found_at": "2020-01-31T23:00:00Z"
      },
      "ofac": {
        "compliant": true,
        "last_found_at": "2020-01-31T23:00:00Z"
      },
      "foundation_code": {
        "compliant": true,
        "last_found_at": "2020-01-31T23:00:00Z"
      },
      "california_attorney_general_registry": {
        "compliant": true,
        "last_found_at": "2020-01-31T23:00:00Z"
      },
      "california_franchise_tax_board": {
        "compliant": true,
        "last_found_at": "2020-01-31T23:00:00Z"
      }
    },
    "mission_statement": "To provide relief to those in need",
    "web": {
      "domain": "redcross.org"
    },
    "officers": [
      {
        "title": "Executive Director"
      }
    ],
    "incorporation": {
      "formation_year": "2005",
      "state": "AZ",
      "ruling_date": "2020-07"
    }
  },
  "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
  "amount": 10000,
  "description": "Annual grant to Acme Inc.",
  "created_at": "2020-01-31T23:00:00Z",
  "updated_at": "2020-01-31T23:00:00Z",
  "status": "pending_approval",
  "cancelation": {
    "canceled_by": "user@example.com",
    "canceled_at": "2020-01-31T23:00:00Z"
  },
  "approval": {
    "approved_by": "user@example.com",
    "approved_at": "2020-01-31T23:00:00Z"
  },
  "rejection": {
    "reason": "insufficient_funds",
    "rejected_at": "2020-01-31T23:00:00Z"
  },
  "verification": {
    "verified_at": "2020-01-31T23:00:00Z"
  },
  "stop": {
    "stopped_by": "user@example.com",
    "stopped_at": "2020-01-31T23:00:00Z"
  },
  "program_details": {
    "id": "program_01jpjenf5q6cawy43yxfcrxhct",
    "name": "Annual Grants"
  },
  "transfers": [
    {
      "account_transfer": {
        "transfer_id": "account_transfer_01j8rs605a4gctmbm58d87mvsj",
        "amount": 10000,
        "status": "complete",
        "created_at": "2020-01-31T23:00:00Z",
        "updated_at": "2020-01-31T23:00:00Z"
      },
      "ach_transfer": {
        "transfer_id": "ach_transfer_01j8rs605a4gctmbm58d87mvsj",
        "amount": 10000,
        "status": "initiated",
        "direction": "credit",
        "standard_entry_class_code": "corporate_credit_or_debit",
        "company_entry_description": "Disbursement to nonprofit",
        "trace_number": "012345678901234",
        "effective_date": "2020-01-31T23:00:00Z",
        "submitted_at": "2020-01-31T23:00:00Z",
        "settled_at": "2020-07-12 15:00:00.000",
        "rejected_at": "2020-07-12 15:00:00.000",
        "returned_at": "2020-07-12 15:00:00.000",
        "created_at": "2020-01-31T23:00:00Z",
        "updated_at": "2020-01-31T23:00:00Z"
      },
      "check_transfer": {
        "transfer_id": "check_transfer_01j8rs605a4gctmbm58d87mvsj",
        "amount": 10000,
        "status": "issued",
        "memo": "Disbursement to nonprofit",
        "note": "Please deposit promptly",
        "check_number": "123456789",
        "recipient_name": "Charity Good",
        "mailing_address": {
          "city": "New York",
          "country": "US",
          "line1": "123 Main St.",
          "line2": "Suite 2504",
          "postal_code": "12345",
          "state": "NY"
        },
        "bank_of_first_deposit_routing_number": "021000089",
        "postal_tracking_updates": [
          {
            "id": 1,
            "event_type": "in_transit",
            "created_at": "2020-01-31T23:00:00Z"
          }
        ],
        "submitted_at": "2020-01-31T23:00:00Z",
        "canceled_at": "2020-01-31T23:00:00Z",
        "stopped_at": "2020-01-31T23:00:00Z",
        "deposited_at": "2020-01-31T23:00:00Z",
        "created_at": "2020-01-31T23:00:00Z",
        "updated_at": "2020-01-31T23:00:00Z"
      },
      "real_time_payments_transfer": {
        "transfer_id": "real_time_payments_transfer_01j8rs605a4gctmbm58d87mvsj",
        "amount": 10000,
        "status": "complete",
        "creditor_name": "Acme Inc.",
        "remittance_information": "Real-Time Payment: Acme Inc.",
        "transaction_identification": "20260101101050001T1BTEST01234557890",
        "submitted_at": "2020-01-31T23:00:00Z",
        "acknowledged_at": "2020-01-31T23:00:05Z",
        "rejected_at": "2020-01-31T23:00:05Z",
        "created_at": "2020-01-31T23:00:00Z",
        "updated_at": "2020-01-31T23:00:00Z"
      }
    }
  ],
  "transactions": [
    {
      "id": "txn_1LaXpKGUcADgqoEMl0Cx0Ygg",
      "amount": 10000,
      "fee_amount": 500,
      "net_amount": 9500,
      "description": "Disbursement to nonprofit",
      "donor_advised_fund_grant": {
        "grant_id": "grant_1234567890",
        "organization_name": "Vanguard Charitable",
        "fund_name": "John Doe Fund",
        "purpose": "General Operating Support",
        "note": "This grant is for the general operating support of the organization.",
        "donors": [
          {
            "full_name": "John Doe",
            "first_name": "John",
            "last_name": "Doe",
            "email": "bob@me.com",
            "phone": "415-555-1212",
            "address": {
              "city": "New York",
              "country": "US",
              "line1": "123 Main St.",
              "postal_code": "12345",
              "state": "NY"
            }
          }
        ]
      },
      "created_at": "2020-01-31T23:00:00Z",
      "updated_at": "2020-01-31T23:00:00Z"
    }
  ]
}