---
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.
      - `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.

## 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

---

[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)