CHchariot-giving
deposits

List Deposits

Changed on

List deposits for your account.

get/v1/deposits

Request

  • Base URL
    https://sandboxapi.givechariot.com
  • URL
    https://sandboxapi.givechariot.com/v1/deposits
  • Auth
    HTTP bearer

Query parameters

limitinteger

Limit the size of the list that is returned. The default (and maximum) is 100 objects.

page_tokenstring

The cursor to use for pagination. If not set, the first page of results will be returned.

source_idstring

The identifier of the source that sent the deposits. Comma-separated list of source IDs.

payment_source_idstring

Deprecated. Use source_id. Comma-separated list of payment source IDs.

status.instring[]

Filter deposits to only those with the specified status. For GET requests, encode this as a comma-delimited string, such as ?status.in=pending,complete.

settled_at.afterstring date-time

Return deposits with a settled date and time after the given date and time.

settled_at.beforestring date-time

Return deposits with a settled date and time before the given date and time.

has_donationsboolean

When true, returns only deposits with at least one donation reconciled to them. When false, returns only deposits with no donations. A deposit counts as having donations even when the donation amounts don't add up to the deposit amount.

Response

The response for Deposits.list

next_page_tokenstring

A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

Example response

{
  "results": [
    {
      "id": "deposit_01j8rs605a4gctmbm58d87mvsj",
      "source_id": "source_01m12tn300eh20gdqscje7s5jw",
      "deposit_address_id": "deposit_address_01m12tn300eh20gdqscje7s5jw",
      "status": "complete",
      "settled_at": "2026-09-25T18:00:00Z",
      "donation_count": 1,
      "transfer": {
        "amount": 25000,
        "currency": "USD",
        "financial_account_id": "fa_01j8rs605a4gctmbm58d87mvsj",
        "description": "FIDELITY CHARITABLE GRANT",
        "bank_created_at": "2026-09-25T14:00:00Z",
        "inbound_ach_transfer": {
          "standard_entry_class_code": "CCD",
          "company_entry_description": "GRANTPMT",
          "originator_routing_number": "021000021",
          "originator_company_name": "Fidelity Charitable",
          "trace_number": "021000021234567",
          "effective_date": "2026-09-25T00:00:00Z",
          "status": "accepted",
          "company_discretionary_data": "GRANT-2026-001",
          "payment_related_info": "Grant 12345 for the Annual Fund"
        }
      },
      "properties": [],
      "created_at": "2026-09-25T14:00:00Z",
      "updated_at": "2026-09-25T18:00:00Z"
    }
  ]
}

Changes

  • 2026-10-01f4ff1656e498Revision changes
    • info

      added the optional property //////////// to the response with the status

  • 2026-10-019ad7585463adRevision changes
    • warning

      deleted the query request parameter status

    • info

      added the new optional query request parameter status.in