Create multiple disbursements

POST

/v1/disbursements/bulk

POST

/v1/disbursements/bulk

$ curl -X POST https://api.givechariot.com/v1/disbursements/bulk \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "disbursements": [
>     {
>       "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
>       "amount": 25000,
>       "transactions": [
>         {
>           "amount": 15000,
>           "type": "donor_advised_fund_grant",
>           "internal_transaction_id": "GRANT-001",
>           "purpose": "General Operating Support",
>           "note": "Allocate to education programs",
>           "donors": {
>             "primary_donor": {
>               "first_name": "Jane",
>               "last_name": "Doe",
>               "email": "jane.doe@example.com"
>             }
>           },
>           "daf_grant": {
>             "fund_name": "Doe Family Charitable Fund"
>           }
>         },
>         {
>           "amount": 10000,
>           "type": "corporate_match",
>           "internal_transaction_id": "MATCH-001",
>           "purpose": "Corporate matching gift",
>           "note": "Matched employee donation",
>           "donors": {
>             "primary_donor": {
>               "first_name": "John",
>               "last_name": "Smith",
>               "email": "john.smith@example.com"
>             }
>           },
>           "corporate_match": {
>             "company_name": "Acme Corporation"
>           }
>         }
>       ]
>     },
>     {
>       "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
>       "amount": 20000,
>       "transactions": [
>         {
>           "amount": 12000,
>           "type": "donor_advised_fund_grant",
>           "internal_transaction_id": "GRANT-002",
>           "purpose": "Youth Programs",
>           "note": "Annual grant for youth services",
>           "donors": {
>             "primary_donor": {
>               "first_name": "Alice",
>               "last_name": "Williams",
>               "email": "alice.williams@example.com"
>             }
>           },
>           "daf_grant": {
>             "fund_name": "Williams Family Foundation"
>           }
>         },
>         {
>           "amount": 8000,
>           "type": "corporate_match",
>           "internal_transaction_id": "MATCH-002",
>           "purpose": "Corporate matching gift",
>           "note": "Matched employee donation",
>           "donors": {
>             "primary_donor": {
>               "first_name": "Bob",
>               "last_name": "Chen",
>               "email": "bob.chen@example.com"
>             }
>           },
>           "corporate_match": {
>             "company_name": "TechCorp Inc."
>           }
>         }
>       ]
>     }
>   ]
> }'

1 {
2   "disbursements": [
3     {
4       "id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
5       "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
6       "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
7       "amount": 25000,
8       "organization": {
9         "id": "org_01jpjenf5q6cawy43yxfcrxhct",
10         "ein": "123456789",
11         "name": "Local Community Foundation",
12         "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
13         "physical_address": {
14           "city": "San Francisco",
15           "country": "US",
16           "line1": "456 Oak Avenue",
17           "postal_code": "94105",
18           "state": "CA",
19           "line2": "Suite 200"
20         },
21         "classification": {
22           "group_exemption_number": "0000",
23           "subsection_code": {
24             "code": 3,
25             "name": "501(C)(3)",
26             "description": "Organizations described in section 501(c)(3)"
27           },
28           "filing_requirement_code": {
29             "code": 1,
30             "name": "990_REQUIRED",
31             "description": "990 - Required to file Form 990"
32           },
33           "foundation_code": {
34             "code": 15,
35             "name": "PUBLIC_CHARITY",
36             "description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
37           },
38           "affiliation_code": {
39             "code": 3,
40             "name": "INDEPENDENT",
41             "description": "Independent - the organization is an independent organization"
42           },
43           "organization_code": {
44             "code": 1,
45             "name": "CORPORATION",
46             "description": "Corporation"
47           },
48           "exempt_status_code": {
49             "code": 1,
50             "name": "UNCONDITIONAL",
51             "description": "Unconditional Exemption"
52           },
53           "deductibility_code": {
54             "code": 1,
55             "name": "DEDUCTIBLE",
56             "description": "Contributions are deductible"
57           },
58           "ntee_code": {
59             "code": "T31",
60             "description": "Community Foundations",
61             "parent_code": "T",
62             "parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
63           },
64           "naics_code": {
65             "naics2": "81",
66             "naics2_description": "Other Services",
67             "naics4": "8134",
68             "naics4_description": "Civic and Social Organizations",
69             "naics6": "813410",
70             "naics6_description": "Civic and Social Organizations"
71           }
72         },
73         "compliance": {
74           "daf_eligible": true,
75           "irs_pub_78": {
76             "compliant": true,
77             "reason": "Organization found in IRS Publication 78",
78             "last_found_at": "2026-03-01T00:00:00Z"
79           },
80           "ofac": {
81             "compliant": true,
82             "reason": "No matches found on OFAC SDN list",
83             "last_found_at": "2026-03-01T00:00:00Z"
84           },
85           "foundation_code": {
86             "compliant": true,
87             "reason": "Foundation code is eligible",
88             "last_found_at": "2026-03-01T00:00:00Z"
89           },
90           "california_attorney_general_registry": {
91             "compliant": true,
92             "reason": "Registered with California Attorney General",
93             "last_found_at": "2026-03-01T00:00:00Z"
94           },
95           "california_franchise_tax_board": {
96             "compliant": true,
97             "reason": "Listed on California Franchise Tax Board",
98             "last_found_at": "2026-03-01T00:00:00Z"
99           }
100         },
101         "mission_statement": "Supporting local communities through education and outreach",
102         "web": {
103           "domain": "localcommunityfoundation.org"
104         },
105         "brand": {
106           "icon_url": "https://cdn.example.com/lcf-icon.png",
107           "logo_url": "https://cdn.example.com/lcf-logo.png"
108         },
109         "officers": [
110           {
111             "name": "Sarah Johnson",
112             "title": "Executive Director"
113           }
114         ],
115         "claimed": true,
116         "incorporation": {
117           "formation_year": "2010",
118           "state": "CA",
119           "ruling_date": "2010-09"
120         }
121       },
122       "auto_fund": false,
123       "created_at": "2026-04-01T12:00:00Z",
124       "updated_at": "2026-04-01T12:00:00Z",
125       "status": "pending_approval",
126       "bypass_chariot_organization_verification": false,
127       "transactions": [
128         {
129           "amount": 15000,
130           "net_amount": 15000,
131           "type": "donor_advised_fund_grant",
132           "id": "txn_01jpjen1s23s29kkmnjsb6fzga",
133           "internal_transaction_id": "GRANT-001",
134           "purpose": "General Operating Support",
135           "note": "Allocate to education programs",
136           "donors": {
137             "primary_donor": {
138               "first_name": "Jane",
139               "last_name": "Doe",
140               "email": "jane.doe@example.com"
141             }
142           },
143           "daf_grant": {
144             "fund_name": "Doe Family Charitable Fund"
145           },
146           "created_at": "2026-04-01T12:00:00Z",
147           "updated_at": "2026-04-01T12:00:00Z"
148         },
149         {
150           "amount": 10000,
151           "net_amount": 10000,
152           "type": "corporate_match",
153           "id": "txn_02jpjen1s23s29kkmnjsb6fzga",
154           "internal_transaction_id": "MATCH-001",
155           "purpose": "Corporate matching gift",
156           "note": "Matched employee donation",
157           "donors": {
158             "primary_donor": {
159               "first_name": "John",
160               "last_name": "Smith",
161               "email": "john.smith@example.com"
162             }
163           },
164           "corporate_match": {
165             "company_name": "Acme Corporation"
166           },
167           "created_at": "2026-04-01T12:00:00Z",
168           "updated_at": "2026-04-01T12:00:00Z"
169         }
170       ]
171     },
172     {
173       "id": "disbursement_02jpjen1s23s29kkmnjsb6fzga",
174       "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
175       "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
176       "amount": 20000,
177       "organization": {
178         "id": "org_01jpjenf5q6cawy43yxfcrxhct",
179         "ein": "123456789",
180         "name": "Local Community Foundation",
181         "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
182         "physical_address": {
183           "city": "San Francisco",
184           "country": "US",
185           "line1": "456 Oak Avenue",
186           "postal_code": "94105",
187           "state": "CA",
188           "line2": "Suite 200"
189         },
190         "classification": {
191           "group_exemption_number": "0000",
192           "subsection_code": {
193             "code": 3,
194             "name": "501(C)(3)",
195             "description": "Organizations described in section 501(c)(3)"
196           },
197           "filing_requirement_code": {
198             "code": 1,
199             "name": "990_REQUIRED",
200             "description": "990 - Required to file Form 990"
201           },
202           "foundation_code": {
203             "code": 15,
204             "name": "PUBLIC_CHARITY",
205             "description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
206           },
207           "affiliation_code": {
208             "code": 3,
209             "name": "INDEPENDENT",
210             "description": "Independent - the organization is an independent organization"
211           },
212           "organization_code": {
213             "code": 1,
214             "name": "CORPORATION",
215             "description": "Corporation"
216           },
217           "exempt_status_code": {
218             "code": 1,
219             "name": "UNCONDITIONAL",
220             "description": "Unconditional Exemption"
221           },
222           "deductibility_code": {
223             "code": 1,
224             "name": "DEDUCTIBLE",
225             "description": "Contributions are deductible"
226           },
227           "ntee_code": {
228             "code": "T31",
229             "description": "Community Foundations",
230             "parent_code": "T",
231             "parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
232           },
233           "naics_code": {
234             "naics2": "81",
235             "naics2_description": "Other Services",
236             "naics4": "8134",
237             "naics4_description": "Civic and Social Organizations",
238             "naics6": "813410",
239             "naics6_description": "Civic and Social Organizations"
240           }
241         },
242         "compliance": {
243           "daf_eligible": true,
244           "irs_pub_78": {
245             "compliant": true,
246             "reason": "Organization found in IRS Publication 78",
247             "last_found_at": "2026-03-01T00:00:00Z"
248           },
249           "ofac": {
250             "compliant": true,
251             "reason": "No matches found on OFAC SDN list",
252             "last_found_at": "2026-03-01T00:00:00Z"
253           },
254           "foundation_code": {
255             "compliant": true,
256             "reason": "Foundation code is eligible",
257             "last_found_at": "2026-03-01T00:00:00Z"
258           },
259           "california_attorney_general_registry": {
260             "compliant": true,
261             "reason": "Registered with California Attorney General",
262             "last_found_at": "2026-03-01T00:00:00Z"
263           },
264           "california_franchise_tax_board": {
265             "compliant": true,
266             "reason": "Listed on California Franchise Tax Board",
267             "last_found_at": "2026-03-01T00:00:00Z"
268           }
269         },
270         "mission_statement": "Supporting local communities through education and outreach",
271         "web": {
272           "domain": "localcommunityfoundation.org"
273         },
274         "brand": {
275           "icon_url": "https://cdn.example.com/lcf-icon.png",
276           "logo_url": "https://cdn.example.com/lcf-logo.png"
277         },
278         "officers": [
279           {
280             "name": "Sarah Johnson",
281             "title": "Executive Director"
282           }
283         ],
284         "claimed": true,
285         "incorporation": {
286           "formation_year": "2010",
287           "state": "CA",
288           "ruling_date": "2010-09"
289         }
290       },
291       "auto_fund": false,
292       "created_at": "2026-04-01T12:00:00Z",
293       "updated_at": "2026-04-01T12:00:00Z",
294       "status": "pending_approval",
295       "bypass_chariot_organization_verification": false,
296       "transactions": [
297         {
298           "amount": 12000,
299           "net_amount": 12000,
300           "type": "donor_advised_fund_grant",
301           "id": "txn_03jpjen1s23s29kkmnjsb6fzga",
302           "internal_transaction_id": "GRANT-002",
303           "purpose": "Youth Programs",
304           "note": "Annual grant for youth services",
305           "donors": {
306             "primary_donor": {
307               "first_name": "Alice",
308               "last_name": "Williams",
309               "email": "alice.williams@example.com"
310             }
311           },
312           "daf_grant": {
313             "fund_name": "Williams Family Foundation"
314           },
315           "created_at": "2026-04-01T12:00:00Z",
316           "updated_at": "2026-04-01T12:00:00Z"
317         },
318         {
319           "amount": 8000,
320           "net_amount": 8000,
321           "type": "corporate_match",
322           "id": "txn_04jpjen1s23s29kkmnjsb6fzga",
323           "internal_transaction_id": "MATCH-002",
324           "purpose": "Corporate matching gift",
325           "note": "Matched employee donation",
326           "donors": {
327             "primary_donor": {
328               "first_name": "Bob",
329               "last_name": "Chen",
330               "email": "bob.chen@example.com"
331             }
332           },
333           "corporate_match": {
334             "company_name": "TechCorp Inc."
335           },
336           "created_at": "2026-04-01T12:00:00Z",
337           "updated_at": "2026-04-01T12:00:00Z"
338         }
339       ]
340     }
341   ],
342   "count": 2
343 }

Create multiple disbursements in a single request. This is useful for batch operations where you need to create many disbursements at once. All disbursements in the request will be created together. If any disbursement fails validation, the entire request will fail and no disbursements will be created.

curl -X POST https://api.givechariot.com/v1/disbursements/bulk \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "disbursements": [
    {
      "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
      "amount": 25000,
      "transactions": [
        {
          "amount": 15000,
          "type": "donor_advised_fund_grant",
          "internal_transaction_id": "GRANT-001",
          "purpose": "General Operating Support",
          "note": "Allocate to education programs",
          "donors": {
            "primary_donor": {
              "first_name": "Jane",
              "last_name": "Doe",
              "email": "jane.doe@example.com"
            }
          },
          "daf_grant": {
            "fund_name": "Doe Family Charitable Fund"
          }
        },
        {
          "amount": 10000,
          "type": "corporate_match",
          "internal_transaction_id": "MATCH-001",
          "purpose": "Corporate matching gift",
          "note": "Matched employee donation",
          "donors": {
            "primary_donor": {
              "first_name": "John",
              "last_name": "Smith",
              "email": "john.smith@example.com"
            }
          },
          "corporate_match": {
            "company_name": "Acme Corporation"
          }
        }
      ]
    },
    {
      "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
      "amount": 20000,
      "transactions": [
        {
          "amount": 12000,
          "type": "donor_advised_fund_grant",
          "internal_transaction_id": "GRANT-002",
          "purpose": "Youth Programs",
          "note": "Annual grant for youth services",
          "donors": {
            "primary_donor": {
              "first_name": "Alice",
              "last_name": "Williams",
              "email": "alice.williams@example.com"
            }
          },
          "daf_grant": {
            "fund_name": "Williams Family Foundation"
          }
        },
        {
          "amount": 8000,
          "type": "corporate_match",
          "internal_transaction_id": "MATCH-002",
          "purpose": "Corporate matching gift",
          "note": "Matched employee donation",
          "donors": {
            "primary_donor": {
              "first_name": "Bob",
              "last_name": "Chen",
              "email": "bob.chen@example.com"
            }
          },
          "corporate_match": {
            "company_name": "TechCorp Inc."
          }
        }
      ]
    }
  ]
}'

{
  "disbursements": [
    {
      "id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
      "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
      "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
      "amount": 25000,
      "organization": {
        "id": "org_01jpjenf5q6cawy43yxfcrxhct",
        "ein": "123456789",
        "name": "Local Community Foundation",
        "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
        "physical_address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "456 Oak Avenue",
          "postal_code": "94105",
          "state": "CA",
          "line2": "Suite 200"
        },
        "classification": {
          "group_exemption_number": "0000",
          "subsection_code": {
            "code": 3,
            "name": "501(C)(3)",
            "description": "Organizations described in section 501(c)(3)"
          },
          "filing_requirement_code": {
            "code": 1,
            "name": "990_REQUIRED",
            "description": "990 - Required to file Form 990"
          },
          "foundation_code": {
            "code": 15,
            "name": "PUBLIC_CHARITY",
            "description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
          },
          "affiliation_code": {
            "code": 3,
            "name": "INDEPENDENT",
            "description": "Independent - the organization is an independent organization"
          },
          "organization_code": {
            "code": 1,
            "name": "CORPORATION",
            "description": "Corporation"
          },
          "exempt_status_code": {
            "code": 1,
            "name": "UNCONDITIONAL",
            "description": "Unconditional Exemption"
          },
          "deductibility_code": {
            "code": 1,
            "name": "DEDUCTIBLE",
            "description": "Contributions are deductible"
          },
          "ntee_code": {
            "code": "T31",
            "description": "Community Foundations",
            "parent_code": "T",
            "parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
          },
          "naics_code": {
            "naics2": "81",
            "naics2_description": "Other Services",
            "naics4": "8134",
            "naics4_description": "Civic and Social Organizations",
            "naics6": "813410",
            "naics6_description": "Civic and Social Organizations"
          }
        },
        "compliance": {
          "daf_eligible": true,
          "irs_pub_78": {
            "compliant": true,
            "reason": "Organization found in IRS Publication 78",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "ofac": {
            "compliant": true,
            "reason": "No matches found on OFAC SDN list",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "foundation_code": {
            "compliant": true,
            "reason": "Foundation code is eligible",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "california_attorney_general_registry": {
            "compliant": true,
            "reason": "Registered with California Attorney General",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "california_franchise_tax_board": {
            "compliant": true,
            "reason": "Listed on California Franchise Tax Board",
            "last_found_at": "2026-03-01T00:00:00Z"
          }
        },
        "mission_statement": "Supporting local communities through education and outreach",
        "web": {
          "domain": "localcommunityfoundation.org"
        },
        "brand": {
          "icon_url": "https://cdn.example.com/lcf-icon.png",
          "logo_url": "https://cdn.example.com/lcf-logo.png"
        },
        "officers": [
          {
            "name": "Sarah Johnson",
            "title": "Executive Director"
          }
        ],
        "claimed": true,
        "incorporation": {
          "formation_year": "2010",
          "state": "CA",
          "ruling_date": "2010-09"
        }
      },
      "auto_fund": false,
      "created_at": "2026-04-01T12:00:00Z",
      "updated_at": "2026-04-01T12:00:00Z",
      "status": "pending_approval",
      "bypass_chariot_organization_verification": false,
      "transactions": [
        {
          "amount": 15000,
          "net_amount": 15000,
          "type": "donor_advised_fund_grant",
          "id": "txn_01jpjen1s23s29kkmnjsb6fzga",
          "internal_transaction_id": "GRANT-001",
          "purpose": "General Operating Support",
          "note": "Allocate to education programs",
          "donors": {
            "primary_donor": {
              "first_name": "Jane",
              "last_name": "Doe",
              "email": "jane.doe@example.com"
            }
          },
          "daf_grant": {
            "fund_name": "Doe Family Charitable Fund"
          },
          "created_at": "2026-04-01T12:00:00Z",
          "updated_at": "2026-04-01T12:00:00Z"
        },
        {
          "amount": 10000,
          "net_amount": 10000,
          "type": "corporate_match",
          "id": "txn_02jpjen1s23s29kkmnjsb6fzga",
          "internal_transaction_id": "MATCH-001",
          "purpose": "Corporate matching gift",
          "note": "Matched employee donation",
          "donors": {
            "primary_donor": {
              "first_name": "John",
              "last_name": "Smith",
              "email": "john.smith@example.com"
            }
          },
          "corporate_match": {
            "company_name": "Acme Corporation"
          },
          "created_at": "2026-04-01T12:00:00Z",
          "updated_at": "2026-04-01T12:00:00Z"
        }
      ]
    },
    {
      "id": "disbursement_02jpjen1s23s29kkmnjsb6fzga",
      "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
      "program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
      "amount": 20000,
      "organization": {
        "id": "org_01jpjenf5q6cawy43yxfcrxhct",
        "ein": "123456789",
        "name": "Local Community Foundation",
        "parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
        "physical_address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "456 Oak Avenue",
          "postal_code": "94105",
          "state": "CA",
          "line2": "Suite 200"
        },
        "classification": {
          "group_exemption_number": "0000",
          "subsection_code": {
            "code": 3,
            "name": "501(C)(3)",
            "description": "Organizations described in section 501(c)(3)"
          },
          "filing_requirement_code": {
            "code": 1,
            "name": "990_REQUIRED",
            "description": "990 - Required to file Form 990"
          },
          "foundation_code": {
            "code": 15,
            "name": "PUBLIC_CHARITY",
            "description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
          },
          "affiliation_code": {
            "code": 3,
            "name": "INDEPENDENT",
            "description": "Independent - the organization is an independent organization"
          },
          "organization_code": {
            "code": 1,
            "name": "CORPORATION",
            "description": "Corporation"
          },
          "exempt_status_code": {
            "code": 1,
            "name": "UNCONDITIONAL",
            "description": "Unconditional Exemption"
          },
          "deductibility_code": {
            "code": 1,
            "name": "DEDUCTIBLE",
            "description": "Contributions are deductible"
          },
          "ntee_code": {
            "code": "T31",
            "description": "Community Foundations",
            "parent_code": "T",
            "parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
          },
          "naics_code": {
            "naics2": "81",
            "naics2_description": "Other Services",
            "naics4": "8134",
            "naics4_description": "Civic and Social Organizations",
            "naics6": "813410",
            "naics6_description": "Civic and Social Organizations"
          }
        },
        "compliance": {
          "daf_eligible": true,
          "irs_pub_78": {
            "compliant": true,
            "reason": "Organization found in IRS Publication 78",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "ofac": {
            "compliant": true,
            "reason": "No matches found on OFAC SDN list",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "foundation_code": {
            "compliant": true,
            "reason": "Foundation code is eligible",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "california_attorney_general_registry": {
            "compliant": true,
            "reason": "Registered with California Attorney General",
            "last_found_at": "2026-03-01T00:00:00Z"
          },
          "california_franchise_tax_board": {
            "compliant": true,
            "reason": "Listed on California Franchise Tax Board",
            "last_found_at": "2026-03-01T00:00:00Z"
          }
        },
        "mission_statement": "Supporting local communities through education and outreach",
        "web": {
          "domain": "localcommunityfoundation.org"
        },
        "brand": {
          "icon_url": "https://cdn.example.com/lcf-icon.png",
          "logo_url": "https://cdn.example.com/lcf-logo.png"
        },
        "officers": [
          {
            "name": "Sarah Johnson",
            "title": "Executive Director"
          }
        ],
        "claimed": true,
        "incorporation": {
          "formation_year": "2010",
          "state": "CA",
          "ruling_date": "2010-09"
        }
      },
      "auto_fund": false,
      "created_at": "2026-04-01T12:00:00Z",
      "updated_at": "2026-04-01T12:00:00Z",
      "status": "pending_approval",
      "bypass_chariot_organization_verification": false,
      "transactions": [
        {
          "amount": 12000,
          "net_amount": 12000,
          "type": "donor_advised_fund_grant",
          "id": "txn_03jpjen1s23s29kkmnjsb6fzga",
          "internal_transaction_id": "GRANT-002",
          "purpose": "Youth Programs",
          "note": "Annual grant for youth services",
          "donors": {
            "primary_donor": {
              "first_name": "Alice",
              "last_name": "Williams",
              "email": "alice.williams@example.com"
            }
          },
          "daf_grant": {
            "fund_name": "Williams Family Foundation"
          },
          "created_at": "2026-04-01T12:00:00Z",
          "updated_at": "2026-04-01T12:00:00Z"
        },
        {
          "amount": 8000,
          "net_amount": 8000,
          "type": "corporate_match",
          "id": "txn_04jpjen1s23s29kkmnjsb6fzga",
          "internal_transaction_id": "MATCH-002",
          "purpose": "Corporate matching gift",
          "note": "Matched employee donation",
          "donors": {
            "primary_donor": {
              "first_name": "Bob",
              "last_name": "Chen",
              "email": "bob.chen@example.com"
            }
          },
          "corporate_match": {
            "company_name": "TechCorp Inc."
          },
          "created_at": "2026-04-01T12:00:00Z",
          "updated_at": "2026-04-01T12:00:00Z"
        }
      ]
    }
  ],
  "count": 2
}

Create multiple disbursements

Create multiple disbursements

Authentication

Request

Response

Errors

Authentication

Request

Response

Errors

$	curl -X POST https://api.givechariot.com/v1/disbursements/bulk \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"disbursements": [
>	{
>	"organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
>	"amount": 25000,
>	"transactions": [
>	{
>	"amount": 15000,
>	"type": "donor_advised_fund_grant",
>	"internal_transaction_id": "GRANT-001",
>	"purpose": "General Operating Support",
>	"note": "Allocate to education programs",
>	"donors": {
>	"primary_donor": {
>	"first_name": "Jane",
>	"last_name": "Doe",
>	"email": "jane.doe@example.com"
>	}
>	},
>	"daf_grant": {
>	"fund_name": "Doe Family Charitable Fund"
>	}
>	},
>	{
>	"amount": 10000,
>	"type": "corporate_match",
>	"internal_transaction_id": "MATCH-001",
>	"purpose": "Corporate matching gift",
>	"note": "Matched employee donation",
>	"donors": {
>	"primary_donor": {
>	"first_name": "John",
>	"last_name": "Smith",
>	"email": "john.smith@example.com"
>	}
>	},
>	"corporate_match": {
>	"company_name": "Acme Corporation"
>	}
>	}
>	]
>	},
>	{
>	"organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
>	"amount": 20000,
>	"transactions": [
>	{
>	"amount": 12000,
>	"type": "donor_advised_fund_grant",
>	"internal_transaction_id": "GRANT-002",
>	"purpose": "Youth Programs",
>	"note": "Annual grant for youth services",
>	"donors": {
>	"primary_donor": {
>	"first_name": "Alice",
>	"last_name": "Williams",
>	"email": "alice.williams@example.com"
>	}
>	},
>	"daf_grant": {
>	"fund_name": "Williams Family Foundation"
>	}
>	},
>	{
>	"amount": 8000,
>	"type": "corporate_match",
>	"internal_transaction_id": "MATCH-002",
>	"purpose": "Corporate matching gift",
>	"note": "Matched employee donation",
>	"donors": {
>	"primary_donor": {
>	"first_name": "Bob",
>	"last_name": "Chen",
>	"email": "bob.chen@example.com"
>	}
>	},
>	"corporate_match": {
>	"company_name": "TechCorp Inc."
>	}
>	}
>	]
>	}
>	]
>	}'

1	{
2	"disbursements": [
3	{
4	"id": "disbursement_01jpjen1s23s29kkmnjsb6fzga",
5	"organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
6	"program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
7	"amount": 25000,
8	"organization": {
9	"id": "org_01jpjenf5q6cawy43yxfcrxhct",
10	"ein": "123456789",
11	"name": "Local Community Foundation",
12	"parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
13	"physical_address": {
14	"city": "San Francisco",
15	"country": "US",
16	"line1": "456 Oak Avenue",
17	"postal_code": "94105",
18	"state": "CA",
19	"line2": "Suite 200"
20	},
21	"classification": {
22	"group_exemption_number": "0000",
23	"subsection_code": {
24	"code": 3,
25	"name": "501(C)(3)",
26	"description": "Organizations described in section 501(c)(3)"
27	},
28	"filing_requirement_code": {
29	"code": 1,
30	"name": "990_REQUIRED",
31	"description": "990 - Required to file Form 990"
32	},
33	"foundation_code": {
34	"code": 15,
35	"name": "PUBLIC_CHARITY",
36	"description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
37	},
38	"affiliation_code": {
39	"code": 3,
40	"name": "INDEPENDENT",
41	"description": "Independent - the organization is an independent organization"
42	},
43	"organization_code": {
44	"code": 1,
45	"name": "CORPORATION",
46	"description": "Corporation"
47	},
48	"exempt_status_code": {
49	"code": 1,
50	"name": "UNCONDITIONAL",
51	"description": "Unconditional Exemption"
52	},
53	"deductibility_code": {
54	"code": 1,
55	"name": "DEDUCTIBLE",
56	"description": "Contributions are deductible"
57	},
58	"ntee_code": {
59	"code": "T31",
60	"description": "Community Foundations",
61	"parent_code": "T",
62	"parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
63	},
64	"naics_code": {
65	"naics2": "81",
66	"naics2_description": "Other Services",
67	"naics4": "8134",
68	"naics4_description": "Civic and Social Organizations",
69	"naics6": "813410",
70	"naics6_description": "Civic and Social Organizations"
71	}
72	},
73	"compliance": {
74	"daf_eligible": true,
75	"irs_pub_78": {
76	"compliant": true,
77	"reason": "Organization found in IRS Publication 78",
78	"last_found_at": "2026-03-01T00:00:00Z"
79	},
80	"ofac": {
81	"compliant": true,
82	"reason": "No matches found on OFAC SDN list",
83	"last_found_at": "2026-03-01T00:00:00Z"
84	},
85	"foundation_code": {
86	"compliant": true,
87	"reason": "Foundation code is eligible",
88	"last_found_at": "2026-03-01T00:00:00Z"
89	},
90	"california_attorney_general_registry": {
91	"compliant": true,
92	"reason": "Registered with California Attorney General",
93	"last_found_at": "2026-03-01T00:00:00Z"
94	},
95	"california_franchise_tax_board": {
96	"compliant": true,
97	"reason": "Listed on California Franchise Tax Board",
98	"last_found_at": "2026-03-01T00:00:00Z"
99	}
100	},
101	"mission_statement": "Supporting local communities through education and outreach",
102	"web": {
103	"domain": "localcommunityfoundation.org"
104	},
105	"brand": {
106	"icon_url": "https://cdn.example.com/lcf-icon.png",
107	"logo_url": "https://cdn.example.com/lcf-logo.png"
108	},
109	"officers": [
110	{
111	"name": "Sarah Johnson",
112	"title": "Executive Director"
113	}
114	],
115	"claimed": true,
116	"incorporation": {
117	"formation_year": "2010",
118	"state": "CA",
119	"ruling_date": "2010-09"
120	}
121	},
122	"auto_fund": false,
123	"created_at": "2026-04-01T12:00:00Z",
124	"updated_at": "2026-04-01T12:00:00Z",
125	"status": "pending_approval",
126	"bypass_chariot_organization_verification": false,
127	"transactions": [
128	{
129	"amount": 15000,
130	"net_amount": 15000,
131	"type": "donor_advised_fund_grant",
132	"id": "txn_01jpjen1s23s29kkmnjsb6fzga",
133	"internal_transaction_id": "GRANT-001",
134	"purpose": "General Operating Support",
135	"note": "Allocate to education programs",
136	"donors": {
137	"primary_donor": {
138	"first_name": "Jane",
139	"last_name": "Doe",
140	"email": "jane.doe@example.com"
141	}
142	},
143	"daf_grant": {
144	"fund_name": "Doe Family Charitable Fund"
145	},
146	"created_at": "2026-04-01T12:00:00Z",
147	"updated_at": "2026-04-01T12:00:00Z"
148	},
149	{
150	"amount": 10000,
151	"net_amount": 10000,
152	"type": "corporate_match",
153	"id": "txn_02jpjen1s23s29kkmnjsb6fzga",
154	"internal_transaction_id": "MATCH-001",
155	"purpose": "Corporate matching gift",
156	"note": "Matched employee donation",
157	"donors": {
158	"primary_donor": {
159	"first_name": "John",
160	"last_name": "Smith",
161	"email": "john.smith@example.com"
162	}
163	},
164	"corporate_match": {
165	"company_name": "Acme Corporation"
166	},
167	"created_at": "2026-04-01T12:00:00Z",
168	"updated_at": "2026-04-01T12:00:00Z"
169	}
170	]
171	},
172	{
173	"id": "disbursement_02jpjen1s23s29kkmnjsb6fzga",
174	"organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
175	"program_id": "program_01jpjenf5q6cawy43yxfcrxhct",
176	"amount": 20000,
177	"organization": {
178	"id": "org_01jpjenf5q6cawy43yxfcrxhct",
179	"ein": "123456789",
180	"name": "Local Community Foundation",
181	"parent_organization_id": "org_01j8rs605a4gctmbm58d87mvsk",
182	"physical_address": {
183	"city": "San Francisco",
184	"country": "US",
185	"line1": "456 Oak Avenue",
186	"postal_code": "94105",
187	"state": "CA",
188	"line2": "Suite 200"
189	},
190	"classification": {
191	"group_exemption_number": "0000",
192	"subsection_code": {
193	"code": 3,
194	"name": "501(C)(3)",
195	"description": "Organizations described in section 501(c)(3)"
196	},
197	"filing_requirement_code": {
198	"code": 1,
199	"name": "990_REQUIRED",
200	"description": "990 - Required to file Form 990"
201	},
202	"foundation_code": {
203	"code": 15,
204	"name": "PUBLIC_CHARITY",
205	"description": "Organization that normally receives a substantial part of its support from a governmental unit or from the general public"
206	},
207	"affiliation_code": {
208	"code": 3,
209	"name": "INDEPENDENT",
210	"description": "Independent - the organization is an independent organization"
211	},
212	"organization_code": {
213	"code": 1,
214	"name": "CORPORATION",
215	"description": "Corporation"
216	},
217	"exempt_status_code": {
218	"code": 1,
219	"name": "UNCONDITIONAL",
220	"description": "Unconditional Exemption"
221	},
222	"deductibility_code": {
223	"code": 1,
224	"name": "DEDUCTIBLE",
225	"description": "Contributions are deductible"
226	},
227	"ntee_code": {
228	"code": "T31",
229	"description": "Community Foundations",
230	"parent_code": "T",
231	"parent_description": "Philanthropy, Voluntarism & Grantmaking Foundations"
232	},
233	"naics_code": {
234	"naics2": "81",
235	"naics2_description": "Other Services",
236	"naics4": "8134",
237	"naics4_description": "Civic and Social Organizations",
238	"naics6": "813410",
239	"naics6_description": "Civic and Social Organizations"
240	}
241	},
242	"compliance": {
243	"daf_eligible": true,
244	"irs_pub_78": {
245	"compliant": true,
246	"reason": "Organization found in IRS Publication 78",
247	"last_found_at": "2026-03-01T00:00:00Z"
248	},
249	"ofac": {
250	"compliant": true,
251	"reason": "No matches found on OFAC SDN list",
252	"last_found_at": "2026-03-01T00:00:00Z"
253	},
254	"foundation_code": {
255	"compliant": true,
256	"reason": "Foundation code is eligible",
257	"last_found_at": "2026-03-01T00:00:00Z"
258	},
259	"california_attorney_general_registry": {
260	"compliant": true,
261	"reason": "Registered with California Attorney General",
262	"last_found_at": "2026-03-01T00:00:00Z"
263	},
264	"california_franchise_tax_board": {
265	"compliant": true,
266	"reason": "Listed on California Franchise Tax Board",
267	"last_found_at": "2026-03-01T00:00:00Z"
268	}
269	},
270	"mission_statement": "Supporting local communities through education and outreach",
271	"web": {
272	"domain": "localcommunityfoundation.org"
273	},
274	"brand": {
275	"icon_url": "https://cdn.example.com/lcf-icon.png",
276	"logo_url": "https://cdn.example.com/lcf-logo.png"
277	},
278	"officers": [
279	{
280	"name": "Sarah Johnson",
281	"title": "Executive Director"
282	}
283	],
284	"claimed": true,
285	"incorporation": {
286	"formation_year": "2010",
287	"state": "CA",
288	"ruling_date": "2010-09"
289	}
290	},
291	"auto_fund": false,
292	"created_at": "2026-04-01T12:00:00Z",
293	"updated_at": "2026-04-01T12:00:00Z",
294	"status": "pending_approval",
295	"bypass_chariot_organization_verification": false,
296	"transactions": [
297	{
298	"amount": 12000,
299	"net_amount": 12000,
300	"type": "donor_advised_fund_grant",
301	"id": "txn_03jpjen1s23s29kkmnjsb6fzga",
302	"internal_transaction_id": "GRANT-002",
303	"purpose": "Youth Programs",
304	"note": "Annual grant for youth services",
305	"donors": {
306	"primary_donor": {
307	"first_name": "Alice",
308	"last_name": "Williams",
309	"email": "alice.williams@example.com"
310	}
311	},
312	"daf_grant": {
313	"fund_name": "Williams Family Foundation"
314	},
315	"created_at": "2026-04-01T12:00:00Z",
316	"updated_at": "2026-04-01T12:00:00Z"
317	},
318	{
319	"amount": 8000,
320	"net_amount": 8000,
321	"type": "corporate_match",
322	"id": "txn_04jpjen1s23s29kkmnjsb6fzga",
323	"internal_transaction_id": "MATCH-002",
324	"purpose": "Corporate matching gift",
325	"note": "Matched employee donation",
326	"donors": {
327	"primary_donor": {
328	"first_name": "Bob",
329	"last_name": "Chen",
330	"email": "bob.chen@example.com"
331	}
332	},
333	"corporate_match": {
334	"company_name": "TechCorp Inc."
335	},
336	"created_at": "2026-04-01T12:00:00Z",
337	"updated_at": "2026-04-01T12:00:00Z"
338	}
339	]
340	}
341	],
342	"count": 2
343	}