---
title: "List Deposits"
method: GET
path: "/v1/deposits"
tags: ["deposits"]
---

# List Deposits

`GET /v1/deposits`

List deposits for your account.

## Query parameters

- `limit` integer
- `page_token` string
- `payment_source_id` string
- `settled_at.after` string, date-time
- `settled_at.before` string, date-time

## Response `200`

The response for Deposits.list

- object
  - `results` Deposit[]
    - `id` string, required — The unique identifier for this object.
    - `payment_source_id` string, required — The unique identifier for the payment source that contains the money for the deposit.
    - `settled_at` string, date-time — The date and time when the deposit was settled.
    - `returned_at` string, date-time — The date and time when the deposit was returned.
    - `status` 'pending' | 'complete' | 'failed', required — The status of the deposit.
    - `transfer` Transfer, required — A subhash containing information about the transfer associated with the deposit.
      - `amount` integer, required — The amount of the transfer in minor currency units. For example, for dollars, this is cents.
      - `currency` string, required — The [ISO 4217 code](https://en.wikipedia.org/wiki/ISO_4217) for the transfer's currency.
      - `financial_account_id` string, required — The unique identifier for the financial account that the transfer was made to.
      - `description` string — A description of the transfer.
      - `inbound_account_transfer` InboundAccountTransfer — An instant transfer of funds between two financial accounts. This is the preferred method of transferring funds for Grantmakers within Chariot's Network.
        - `created_at` string, date-time, required — The date and time the account transfer was created
      - `inbound_ach_transfer` InboundAchTransfer — An ACH transfer initiated outside of Chariot to your financial account.
        - `standard_entry_class_code` string — The Standard Entry Class (SEC) code for the ACH transfer.
        - `company_entry_description` string — The company entry description for the ACH transfer.
        - `originator_routing_number` string — The routing number of the originator of the ACH transfer.
        - `originator_company_name` string — The name of the originator of the ACH transfer.
        - `trace_number` string — The trace number for the ACH transfer.
        - `effective_date` string, date-time — The effective date for the ACH transfer.
        - `status` 'pending' | 'declined' | 'accepted' | 'returned' — The status of the ACH transfer.
      - `check_deposit` CheckDeposit — A check deposit represents a physical check that is deposited into a financial account.
        - `auxiliary_on_us` string — An additional line of metadata printed on the check. This typically includes the check number for business checks.
        - `routing_number` string — The routing number printed on the check. This is a routing number for the bank that issued the check.
        - `submitted_at` string, date-time — The date and time the check deposit was submitted.
        - `status` 'pending' | 'deposited' | 'rejected' | 'returned' — The status of the check deposit.
    - `properties` PropertyAssignment[] — A list of properties assigned to the deposit.
      - `property_id` string — The unique identifier for the property.
      - `value` PropertyValue
        - `type` 'text' | 'enum' | 'user' | 'boolean' | 'date', required — The data type of a property.
        - `text_value` string — The text value of the property.
        - `enum_value_id` string — The unique identifier for the enum value.
        - `user_value_id` string — The unique identifier for the user.
        - `boolean_value` boolean — The boolean value of the property.
        - `date_value` string, date-time — The date value of the property.
        - `empty` boolean — Whether the property value is empty. Can use this to unset property values when assigning a property.
    - `created_at` string, date-time, required — The date and time when the deposit was created.
    - `updated_at` string, date-time, required — The date and time when the deposit was last updated.
    - `bank_created_at` string, date-time — The date and time when the bank created the deposit.
  - `next_page_token` string — 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.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/specs.md) · [All operations](https://skmtc.net/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/8446023e02fb/schema)