For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact usLogin
GuidesAPI ReferenceFDX APIChangelog
GuidesAPI ReferenceFDX APIChangelog
  • Introduction
    • Overview
    • Authentication
    • Errors
    • Software Development Kits
    • Webhooks and Events
    • Sandbox Simulations
  • Core Resources
  • DAFpay
  • Donor Accounts
  • Disbursements
      • GETList disbursements
      • POSTCreate a disbursement
      • POSTCreate multiple disbursements
      • GETGet a disbursement
      • POSTApprove a disbursement
      • POSTApprove multiple disbursements
      • POSTCancel a pending disbursement
      • POSTStop payment for a disbursement
      • POSTSandbox: Complete a disbursement
      • POSTSandbox: Fail a disbursement
  • Gift Processing
LogoLogo
Contact usLogin
DisbursementsDisbursements

Approve a disbursement

POST
/v1/disbursements/:id/approve
POST
/v1/disbursements/:id/approve
$curl -X POST https://api.givechariot.com/v1/disbursements/disbursement_01jpjen1s23s29kkmnjsb6fzga/approve \
> -H "Authorization: Bearer <token>"
1{
2 "id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
3 "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
4 "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
5 "amount": 25000,
6 "organization": {
7 "id": "org_01jpjenf5q6cawy43yxfcrxhct",
8 "ein": "123456789",
9 "name": "Local Community Foundation",
10 "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
11 "physical_address": {
12 "city": "San Francisco",
13 "country": "US",
14 "line1": "456 Oak Avenue",
15 "postal_code": "94105",
16 "state": "CA",
17 "line2": "Suite 200"
18 },
19 "classification": {
20 "group_exemption_number": "0000",
21 "subsection_code": {
22 "code": 3,
23 "name": "501(C)(3)",
24 "description": "Organizations described in section 501(c)(3)"
25 },
26 "filing_requirement_code": {
27 "code": 1,
28 "name": "990_REQUIRED",
29 "description": "990 - Required to file Form 990"
30 },
31 "foundation_code": {
32 "code": 15,
33 "name": "PUBLIC_CHARITY",
34 "description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
35 },
36 "affiliation_code": {
37 "code": 3,
38 "name": "INDEPENDENT",
39 "description": "Independent - the organization is an independent organization"
40 },
41 "organization_code": {
42 "code": 1,
43 "name": "CORPORATION",
44 "description": "Corporation"
45 },
46 "exempt_status_code": {
47 "code": 1,
48 "name": "UNCONDITIONAL",
49 "description": "Unconditional Exemption"
50 },
51 "deductibility_code": {
52 "code": 1,
53 "name": "DEDUCTIBLE",
54 "description": "Contributions are deductible"
55 },
56 "ntee_code": {
57 "code": "T31",
58 "description": "Community Foundations",
59 "parent_code": "T",
60 "parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
61 },
62 "naics_code": {
63 "naics2": "81",
64 "naics2_description": "Other Services",
65 "naics4": "8134",
66 "naics4_description": "Civic and Social Organizations",
67 "naics6": "813410",
68 "naics6_description": "Civic and Social Organizations"
69 }
70 },
71 "compliance": {
72 "daf_eligible": true,
73 "irs_pub_78": {
74 "compliant": true,
75 "reason": "Organization found in IRS Publication 78",
76 "last_found_at": "2026-03-01T00:00:00Z"
77 },
78 "ofac": {
79 "compliant": true,
80 "reason": "No matches found on OFAC SDN list",
81 "last_found_at": "2026-03-01T00:00:00Z"
82 },
83 "foundation_code": {
84 "compliant": true,
85 "reason": "Foundation code is eligible",
86 "last_found_at": "2026-03-01T00:00:00Z"
87 },
88 "california_attorney_general_registry": {
89 "compliant": true,
90 "reason": "Registered with California Attorney General",
91 "last_found_at": "2026-03-01T00:00:00Z"
92 },
93 "california_franchise_tax_board": {
94 "compliant": true,
95 "reason": "Listed on California Franchise Tax Board",
96 "last_found_at": "2026-03-01T00:00:00Z"
97 }
98 },
99 "mission_statement": "Supporting local communities through education and outreach",
100 "web": {
101 "domain": "localcommunityfoundation.org"
102 },
103 "brand": {
104 "icon_url": "https://cdn.example.com/lcf-icon.png",
105 "logo_url": "https://cdn.example.com/lcf-logo.png"
106 },
107 "officers": [
108 {
109 "name": "Sarah Johnson",
110 "title": "Executive Director"
111 }
112 ],
113 "claimed": true,
114 "incorporation": {
115 "formation_year": "2010",
116 "state": "CA",
117 "ruling_date": "2010-09"
118 }
119 },
120 "auto_fund": false,
121 "created_at": "2026-04-01T12:00:00Z",
122 "updated_at": "2026-04-01T12:30:00Z",
123 "status": "awaiting_verification",
124 "approval": {
125 "approved_at": "2026-04-01T12:30:00Z"
126 },
127 "bypass_chariot_organization_verification": false,
128 "transactions": [
129 {
130 "amount": 15000,
131 "net_amount": 15000,
132 "type": "donor_advised_fund_grant",
133 "id": "txn_01jpjen1s23s29kkmnjsb6fzga",
134 "internal_transaction_id": "GRANT-001",
135 "purpose": "General Operating Support",
136 "note": "Allocate to education programs",
137 "donors": {
138 "primary_donor": {
139 "first_name": "Jane",
140 "last_name": "Doe",
141 "email": "jane.doe@example.com"
142 }
143 },
144 "daf_grant": {
145 "fund_name": "Doe Family Charitable Fund"
146 },
147 "created_at": "2026-04-01T12:00:00Z",
148 "updated_at": "2026-04-01T12:00:00Z"
149 }
150 ]
151}

Approve a disbursement in a pending_approval state. If the disbursement is in a different state, this will return a 400 error.

Was this page helpful?
Previous

Approve multiple disbursements

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired
The unique identifier for the disbursement

Response

The disbursement was approved
idstringRead-only
The unique identifier for the disbursement
organization_idstring
The unique identifier for the organization that will receive the payment
program_idstring
The unique identifier for the program that the disbursement belongs to
amountlong
The payment amount in USD cents. Must be a positive amount.
organizationobject

An Organization represents an operating nonprofit or an operating sub-organization of a parent or sponsoring nonprofit. The generally accepted identifier for an organization is its domain. This domain provides proof of identity, ownership and relationship to an entity. Organizations can receive payments from payers on the network.

descriptionstring
A description for the disbursement
auto_fundbooleanRead-only

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_atstringRead-onlyformat: "date-time"
The date and time the disbursement was created
updated_atstringRead-onlyformat: "date-time"
The date and time the disbursement was last updated
statusenum

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.

cancelationobject
If your account requires approvals for disbursements and the disbursement was not approved, this will contain the details of the cancelation.
approvalobject
If your account requires approvals for disbursements and the disbursement was approved, this will contain the details of the approval.
rejectionobject
If the disbursement was rejected by Chariot, this will contain details as to why the disbursement was rejected.
verificationobject
If the disbursement has been verified by Chariot, this will contain the verification details.
stopobject
If the disbursement was stopped by the grantmaker after it was submitted, this will contain the details of the stop.
program_detailsobject
Details about the program that the disbursement belongs to.
transferslist of objects
The list of transfers for the disbursement. This can have multiple items if the disbursement's underlying payment was retried multiple times. For example, if a check was returned or stopped and the disbursement was retried as an ACH transfer. If the disbursement was not retried, this will have a single item.
bypass_chariot_organization_verificationboolean
Whether the disbursement bypasses Chariot's organization verification. When true, the disbursement proceeds without waiting for Chariot to verify the organization.
transactionslist of objects
The list of transactions for the disbursement

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error