Create a disbursement

POST

/v1/disbursements

POST

/v1/disbursements

1 curl -X POST https://api.givechariot.com/v1/disbursements \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "organization_id": "org_01j8rs605a4gctmbm58d87mvsj",
6   "amount": 25000,
7   "transactions": [
8     {
9       "amount": 15000,
10       "type": "donor_advised_fund_grant",
11       "description": "Grant from Doe Family Fund",
12       "donor_advised_fund_grant": {
13         "grant_id": "grant_1234567890",
14         "organization_name": "Miami Charitable",
15         "fund_name": "Doe Family Charitable Fund",
16         "purpose": "General Operating Support",
17         "donors": [
18           {
19             "first_name": "Jane",
20             "last_name": "Doe",
21             "email": "jane.doe@example.com"
22           }
23         ]
24       }
25     },
26     {
27       "amount": 10000,
28       "type": "donor_advised_fund_grant",
29       "description": "Grant from Smith Family Fund",
30       "donor_advised_fund_grant": {
31         "organization_name": "LA Charitable",
32         "fund_name": "Smith Family Legacy Fund",
33         "purpose": "Program Support",
34         "donors": [
35           {
36             "first_name": "John",
37             "last_name": "Smith",
38             "email": "john.smith@example.com"
39           }
40         ]
41       }
42     }
43   ],
44   "description": "February 2025 Disbursement"
45 }'

Try it

1 {
2   "id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
3   "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
4   "amount": 10000,
5   "organization": {
6     "id": "org_01j8rs605a4gctmbm58d87mvsj",
7     "ein": "123456789",
8     "name": "American Red Cross",
9     "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
10     "physical_address": {
11       "city": "city",
12       "country": "country",
13       "line1": "line1",
14       "postal_code": "postal_code",
15       "state": "state",
16       "line2": "line2"
17     },
18     "classification": {
19       "group_exemption_number": "group_exemption_number",
20       "subsection_code": {
21         "code": 1,
22         "name": "UNCONDITIONAL",
23         "description": "Unconditional Exemption"
24       },
25       "filing_requirement_code": {
26         "code": 1,
27         "name": "UNCONDITIONAL",
28         "description": "Unconditional Exemption"
29       },
30       "foundation_code": {
31         "code": 1,
32         "name": "UNCONDITIONAL",
33         "description": "Unconditional Exemption"
34       },
35       "affiliation_code": {
36         "code": 1,
37         "name": "UNCONDITIONAL",
38         "description": "Unconditional Exemption"
39       },
40       "organization_code": {
41         "code": 1,
42         "name": "UNCONDITIONAL",
43         "description": "Unconditional Exemption"
44       },
45       "exempt_status_code": {
46         "code": 1,
47         "name": "UNCONDITIONAL",
48         "description": "Unconditional Exemption"
49       },
50       "deductibility_code": {
51         "code": 1,
52         "name": "UNCONDITIONAL",
53         "description": "Unconditional Exemption"
54       },
55       "ntee_code": {
56         "code": "A",
57         "description": "Animal Welfare",
58         "parent_code": "A",
59         "parent_description": "Animal Welfare"
60       },
61       "naics_code": {
62         "naics2": "31",
63         "naics2_description": "Manufacturing",
64         "naics4": "3112",
65         "naics4_description": "Grain and Oilseed Milling",
66         "naics6": "311221",
67         "naics6_description": "Wet Corn Milling and Starch Manufacturing"
68       }
69     },
70     "compliance": {
71       "daf_eligible": true,
72       "irs_pub_78": {
73         "compliant": true,
74         "last_found_at": "2020-01-31T23:00:00Z"
75       },
76       "ofac": {
77         "compliant": true,
78         "last_found_at": "2020-01-31T23:00:00Z"
79       },
80       "foundation_code": {
81         "compliant": true,
82         "last_found_at": "2020-01-31T23:00:00Z"
83       },
84       "california_attorney_general_registry": {
85         "compliant": true,
86         "last_found_at": "2020-01-31T23:00:00Z"
87       },
88       "california_franchise_tax_board": {
89         "compliant": true,
90         "last_found_at": "2020-01-31T23:00:00Z"
91       }
92     },
93     "mission_statement": "To provide relief to those in need",
94     "web": {
95       "domain": "redcross.org"
96     },
97     "brand": {
98       "icon_url": "icon_url",
99       "logo_url": "logo_url"
100     },
101     "officers": [
102       {
103         "name": "name",
104         "title": "Executive Director"
105       }
106     ],
107     "claimed": true
108   },
109   "description": "Disbursement to nonprofit",
110   "auto_fund": false,
111   "created_at": "2020-01-31T23:00:00Z",
112   "updated_at": "2020-01-31T23:00:00Z",
113   "status": "pending_approval",
114   "cancelation": {
115     "canceled_by": "user@example.com",
116     "canceled_at": "2020-01-31T23:00:00Z"
117   },
118   "approval": {
119     "approved_by": "user@example.com",
120     "approved_at": "2020-01-31T23:00:00Z"
121   },
122   "rejection": {
123     "reason": "insufficient_funds",
124     "rejected_at": "2020-01-31T23:00:00Z"
125   },
126   "transfers": [
127     {
128       "account_transfer": {
129         "id": "account_transfer_01j8rs605a4gctmbm58d87mvsj",
130         "amount": 10000,
131         "created_at": "2020-01-31T23:00:00Z"
132       },
133       "ach_transfer": {
134         "id": "ach_transfer_01j8rs605a4gctmbm58d87mvsj",
135         "amount": 10000,
136         "status": "initiated",
137         "created_at": "2020-01-31T23:00:00Z",
138         "company_entry_description": "Disbursement to nonprofit",
139         "trace_number": "012345678901234",
140         "effective_date": "2020-01-31T23:00:00Z",
141         "submitted_at": "2020-01-31T23:00:00Z",
142         "settled_at": "2020-07-12T15:00:00Z",
143         "rejected_at": "2020-07-12T15:00:00Z",
144         "returned_at": "2020-07-12T15:00:00Z",
145         "updated_at": "2020-01-31T23:00:00Z"
146       },
147       "check_transfer": {
148         "id": "check_transfer_01j8rs605a4gctmbm58d87mvsj",
149         "amount": 10000,
150         "status": "pending",
151         "memo": "Disbursement to nonprofit",
152         "mailing_address": {
153           "city": "city",
154           "country": "country",
155           "line1": "line1",
156           "postal_code": "postal_code",
157           "state": "state"
158         },
159         "created_at": "2020-01-31T23:00:00Z",
160         "check_number": "123456789",
161         "recipient_name": "Charity Good",
162         "tracking_updates": [
163           {
164             "category": "in_transit",
165             "created_at": "2020-01-31T23:00:00Z"
166           }
167         ],
168         "submitted_at": "2020-01-31T23:00:00Z",
169         "canceled_at": "2020-01-31T23:00:00Z",
170         "stopped_at": "2020-01-31T23:00:00Z",
171         "deposited_at": "2020-01-31T23:00:00Z",
172         "updated_at": "2020-01-31T23:00:00Z"
173       }
174     }
175   ],
176   "transactions": [
177     {
178       "amount": 10000,
179       "type": "donor_advised_fund_grant",
180       "id": "txn_1LaXpKGUcADgqoEMl0Cx0Ygg",
181       "description": "Disbursement to nonprofit",
182       "donor_advised_fund_grant": {
183         "grant_id": "grant_1234567890",
184         "organization_name": "Vanguard Charitable",
185         "fund_name": "John Doe Fund",
186         "purpose": "General Operating Support",
187         "note": "This grant is for the general operating support of the organization."
188       },
189       "created_at": "2020-01-31T23:00:00Z",
190       "updated_at": "2020-01-31T23:00:00Z",
191       "metadata": {
192         "key": "value"
193       }
194     }
195   ]
196 }

Create a disbursement to send money to an organization.

Request

This endpoint expects an object.

organization_idstringRequired

The ID of the organization that will receive the disbursement.

amountlongRequired

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

transactionslist of objectsRequired

The list of transactions associated with the disbursement. Each transaction is an individual donation to be included in the disbursement. Must specify at least one transaction.

descriptionstringOptional

A description of the disbursement that will be displayed to the receiving organization.

auto_fundbooleanOptionalDefaults to false

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.

Response

The disbursement was created

idstring

The unique identifier for the disbursement

organization_idstring

The unique identifier for the organization that will receive the payment

amountlong

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

organizationobject or null

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 or null

A description of the disbursement that will be displayed to the receiving organization.

auto_fundboolean or null

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_atdatetime or null

The date and time the disbursement was created

updated_atdatetime or null

The date and time the disbursement was last updated

statusenum or null

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. - `pending_submission`: The disbursement is awaiting submission to the payment network - `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 or null

If your account requires approvals for disbursements and the disbursement was not approved, this will contain the details of the cancelation.

approvalobject or null

If your account requires approvals for disbursements and the disbursement was approved, this will contain the details of the approval.

rejectionobject or null

If the disbursement was rejected by Chariot, this will contain details as to why the disbursement was rejected.

transferslist of objects or null

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.

transactionslist of objects or null

The list of transactions for the disbursement

Create a disbursement

Headers

Request

Response

Errors