---
title: "Get a Deposit"
method: GET
path: "/v1/deposits/{id}"
tags: ["deposits"]
---

# Get a Deposit

`GET /v1/deposits/{id}`

Get a deposit by its unique identifier.

## Path parameters

- `id` string, required

## Response `200`

The deposit was retrieved

- Deposit — A Deposit is a transfer of money for a charitable donation or a batch of donations.
  - `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. The time component is always midnight UTC.
      - `status` 'pending' | 'declined' | 'accepted' | 'returned' — The status of the ACH transfer.
      - `company_discretionary_data` string — Optional data set by the originator for their own internal use, taken from the Company Discretionary Data field of the ACH batch header record.
    - `ach_transfer` AchTransfer — An ACH transfer represents an electronic transfer of funds via the Automated Clearing House (ACH) payment network.
      - `transfer_id` string, required — The unique identifier for the ACH transfer
      - `amount` integer, required — The amount of the ACH transfer in minor currency units (cents). For ACH debits, this is a negative number.
      - `status` 'initiated' | 'pending_submission' | 'submitted' | 'completed' | 'rejected' | 'returned' | 'canceled', required — The lifecycle status of the ACH transfer. Possible values include: - `initiated`: The ACH transfer has been initiated and is pending submission to the Federal Reserve. - `pending_submission`: The ACH transfer is queued for submission to the Federal Reserve. - `submitted`: The ACH transfer has been submitted to the Federal Reserve. - `completed`: The ACH transfer has been completed. Funds should be settled. - `rejected`: The ACH transfer was rejected. - `returned`: The ACH transfer was returned by the receiving organization. - `canceled`: The ACH transfer was canceled before submission.
      - `direction` 'credit' | 'debit' — The direction of the ACH transfer.
      - `standard_entry_class_code` 'corporate_credit_or_debit' | 'prearranged_payments_and_deposit' | 'international_ach_transaction' | 'internet_initiated' | 'corporate_trade_exchange' — The Standard Entry Class (SEC) code for the ACH transfer.
      - `company_entry_description` string — The company entry description for the ACH transfer. This is included in the transfer data sent to the receiving bank.
      - `trace_number` string — A 15 digit number recorded in the Nacha file and transmitted to the receiving bank. Along with the amount, date, and originating routing number, this can be used to identify the ACH transfer at the receiving bank. ACH trace numbers are not unique, but are used to correlate returns.
      - `effective_date` string, date-time — The ACH transfer's effective date as sent to the Federal Reserve. This is the date the funds will be available to the receiving organization. The time component is always midnight UTC.
      - `submitted_at` string, date-time — The date and time the ACH transfer was submitted to the Federal Reserve.
      - `settled_at` string, date-time — The date and time at which the ACH transfer was settled. If the transfer is not settled, this will be null.
      - `rejected_at` string, date-time — The date and time at which the ACH transfer was rejected. If the transfer is not rejected, this will be null.
      - `returned_at` string, date-time — The date and time at which the ACH transfer was returned. If the transfer is not returned, this will be null.
      - `created_at` string, date-time, required — The date and time the ACH transfer was created
      - `updated_at` string, date-time — The date and time the ACH transfer was last updated
    - `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.
    - `inbound_real_time_payments_transfer` InboundRealTimePaymentsTransfer — A Real-Time Payments transfer initiated outside of Chariot to your financial account. Inbound Real-Time Payments transfers settle immediately.
      - `status` 'pending_confirmation' | 'confirmed' | 'declined' — The status of the inbound real-time payments transfer.
      - `debtor_name` string — The name of the debtor who sent the transfer.
      - `debtor_routing_number` string — The routing number of the debtor's financial account.
      - `debtor_account_number` string — The account number of the debtor's financial account.
      - `transaction_identification` string — The transaction identification assigned by the sender.
      - `remittance_information` string — Unstructured remittance information sent with the transfer.
      - `confirmed_at` string, date-time — The date and time the transfer was confirmed.
    - `inbound_wire_transfer` InboundWireTransfer — A wire transfer initiated outside of Chariot to your financial account.
      - `status` 'pending_confirmation' | 'confirmed' — The status of the inbound wire transfer.
      - `originator_name` string — The name of the originator who sent the transfer.
      - `originator_routing_number` string — The routing number of the originator's financial account.
      - `originator_account_number` string — The account number of the originator's financial account.
      - `confirmed_at` string, date-time — The date and time the transfer was confirmed.
  - `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.

## 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
- `404` — Resource Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-02** `5adde36601ba` — 4 info
  - added the optional property `transfer/allOf[#/components/schemas/Transfer]/ach_transfer` to the response with the `200` status
  - added the optional property `transfer/allOf[#/components/schemas/Transfer]/inbound_ach_transfer/allOf[#/components/schemas/InboundAchTransfer]/company_discretionary_data` to the response with the `200` status
  - added the optional property `transfer/allOf[#/components/schemas/Transfer]/inbound_real_time_payments_transfer` to the response with the `200` status
  - added the optional property `transfer/allOf[#/components/schemas/Transfer]/inbound_wire_transfer` to the response with the `200` status
- **2026-06-29** `b87f7738d336` — 10 breaking, 25 info
  - removed the required property `code` from the response with the `400` status
  - removed the required property `code` from the response with the `401` status
  - removed the required property `code` from the response with the `403` status
  - removed the required property `code` from the response with the `404` status
  - …31 more
- **2026-06-29** `c65f43c5ad90` — 5 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `401` status
  - removed the optional property `details` from the response with the `403` status
  - removed the optional property `details` from the response with the `404` status
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/chariot-giving/apis/specs/changes/v1/deposits/:id/get.md)

---

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