---
title: "List Check Deposits"
method: GET
path: "/check_deposits"
---

# List Check Deposits

`GET /check_deposits`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `account_id` string — Filter Check Deposits to those belonging to the specified Account.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Check Deposit List

- CheckDepositList — A list of Check Deposit objects.
  - `data` CheckDeposit[], required — The contents of the list.
    - `account_id` string, required — The Account the check was deposited into.
    - `amount` integer, required — The deposited amount in USD cents.
    - `back_image_file_id` string, nullable, required — The ID for the File containing the image of the back of the check.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
    - `deposit_acceptance` object, nullable, required — Once your deposit is successfully parsed and accepted by Increase, this will contain details of the parsed check.
      - `account_number` string, required — The account number printed on the check. This is an account at the bank that issued the check.
      - `amount` integer, required — The amount to be deposited in the minor unit of the transaction's currency. For dollars, for example, this is cents.
      - `auxiliary_on_us` string, nullable, required — An additional line of metadata printed on the check. This typically includes the check number for business checks.
      - `check_deposit_id` string, required — The ID of the Check Deposit that was accepted.
      - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's currency.
      - `routing_number` string, required — The routing number printed on the check. This is a routing number for the bank that issued the check.
      - `serial_number` string, nullable, required — The check serial number, if present, for consumer checks. For business checks, the serial number is usually in the `auxiliary_on_us` field.
    - `deposit_adjustments` object[], required — If the deposit or the return was adjusted by the receiving institution, this will contain details of the adjustments.
      - `adjusted_at` string, date-time, required — The time at which the adjustment was received.
      - `amount` integer, required — The amount of the adjustment.
      - `reason` 'adjusted_amount' | 'non_conforming_item' | 'paid', required — The reason for the adjustment.
      - `transaction_id` string, required — The id of the transaction for the adjustment.
    - `deposit_rejection` object, nullable, required — If your deposit is rejected by Increase, this will contain details as to why it was rejected.
      - `amount` integer, required — The rejected amount in the minor unit of check's currency. For dollars, for example, this is cents.
      - `check_deposit_id` string, required — The identifier of the Check Deposit that was rejected.
      - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the check's currency.
      - `declined_transaction_id` string, required — The identifier of the associated declined transaction.
      - `reason` 'incomplete_image' | 'duplicate' | 'poor_image_quality' | 'incorrect_amount' | 'incorrect_recipient' | 'not_eligible_for_mobile_deposit' | 'missing_required_data_elements' | 'suspected_fraud' | 'deposit_window_expired' | 'requested_by_user' | 'international' | 'unknown', required — Why the check deposit was rejected.
      - `rejected_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the check deposit was rejected.
    - `deposit_return` object, nullable, required — If your deposit is returned, this will contain details as to why it was returned.
      - `amount` integer, required — The returned amount in USD cents.
      - `check_deposit_id` string, required — The identifier of the Check Deposit that was returned.
      - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's currency.
      - `return_reason` 'ach_conversion_not_supported' | 'closed_account' | 'duplicate_submission' | 'insufficient_funds' | 'no_account' | 'not_authorized' | 'stale_dated' | 'stop_payment' | 'unknown_reason' | 'unmatched_details' | 'unreadable_image' | 'endorsement_irregular' | 'altered_or_fictitious_item' | 'frozen_or_blocked_account' | 'post_dated' | 'endorsement_missing' | 'signature_missing' | 'stop_payment_suspect' | 'unusable_image' | 'image_fails_security_check' | 'cannot_determine_amount' | 'signature_irregular' | 'non_cash_item' | 'unable_to_process' | 'item_exceeds_dollar_limit' | 'branch_or_account_sold', required — Why this check was returned by the bank holding the account it was drawn against.
      - `returned_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the check deposit was returned.
      - `transaction_id` string, required — The identifier of the transaction that reversed the original check deposit transaction.
    - `deposit_submission` object, nullable, required — After the check is parsed, it is submitted to the Check21 network for processing. This will contain details of the submission.
      - `back_file_id` string, required — The ID for the File containing the check back image that was submitted to the Check21 network.
      - `front_file_id` string, required — The ID for the File containing the check front image that was submitted to the Check21 network.
      - `submitted_at` string, date-time, required — When the check deposit was submitted to the Check21 network for processing. During business days, this happens within a few hours of the check being accepted by Increase.
    - `description` string, nullable, required — The description of the Check Deposit, for display purposes only.
    - `front_image_file_id` string, required — The ID for the File containing the image of the front of the check.
    - `id` string, required — The deposit's identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `inbound_funds_hold` InboundFundsHold, required — We hold funds for certain transaction types to account for return windows where funds might still be clawed back by the sending institution.
      - `amount` integer, required — The held amount in the minor unit of the account's currency. For dollars, for example, this is cents.
      - `automatically_releases_at` string, date-time, required — When the hold will be released automatically. Certain conditions may cause it to be released before this time.
      - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the hold was created.
      - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the hold's currency.
      - `held_transaction_id` string, nullable, required — The ID of the Transaction for which funds were held.
      - `pending_transaction_id` string, nullable, required — The ID of the Pending Transaction representing the held funds.
      - `released_at` string, date-time, nullable, required — When the hold was released (if it has been released).
      - `status` 'held' | 'complete', required — The status of the hold.
      - `type` 'inbound_funds_hold', required — A constant representing the object's type. For this resource it will always be `inbound_funds_hold`.
    - `inbound_mail_item_id` string, nullable, required — If the Check Deposit was the result of an Inbound Mail Item, this will contain the identifier of the Inbound Mail Item.
    - `lockbox_recipient_id` string, nullable, required — If the Check Deposit was the result of an Inbound Mail Item routed to a Lockbox Recipient, this will contain the identifier of the Lockbox Recipient that received it.
    - `status` 'pending' | 'submitted' | 'rejected' | 'returned', required — The status of the Check Deposit.
    - `transaction_id` string, nullable, required — The ID for the Transaction created by the deposit.
    - `type` 'check_deposit', required — A constant representing the object's type. For this resource it will always be `check_deposit`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)