---
title: "Sandbox: Create an Inbound Check Deposit"
method: POST
path: "/simulations/inbound_check_deposits"
---

# Sandbox: Create an Inbound Check Deposit

`POST /simulations/inbound_check_deposits`

Simulates an Inbound Check Deposit against your account. This imitates someone depositing a check at their bank that was issued from your account. It may or may not be associated with a Check Transfer. The resulting Inbound Check Deposit will have a `status` of `pending`, and after an hour Increase will evaluate it as we would in production and either create a Transaction or a Declined Transaction as a result. To resolve it sooner, use the simulation to accept an Inbound Check Deposit or the API to decline one.

## Request body

- SandboxCreateAnInboundCheckDepositParameters
  - `account_number_id` string, required — The identifier of the Account Number the Inbound Check Deposit will be against.
  - `amount` integer, required — The check amount in cents.
  - `check_number` string, required — The check number on the check to be deposited.
  - `payee_name_analysis` 'name_matches' | 'does_not_match' | 'not_evaluated' — Simulate the outcome of [payee name checking](https://increase.com/documentation/positive-pay#payee-name-mismatches). Defaults to `not_evaluated`.

## Response `200`

Inbound Check Deposit

- InboundCheckDeposit — Inbound Check Deposits are records of third-parties attempting to deposit checks against your account.
  - `accepted_at` string, date-time, nullable, required — If the Inbound Check Deposit was accepted, the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which this took place.
  - `account_id` string, required — The Account the check is being deposited against.
  - `account_number_id` string, nullable, required — The Account Number the check is being deposited against.
  - `adjustments` object[], required — If the deposit or the return was adjusted by the sending institution, this will contain details of the adjustments.
    - `adjusted_at` string, date-time, required — The time at which the return adjustment was received.
    - `amount` integer, required — The amount of the adjustment.
    - `reason` 'late_return' | 'wrong_payee_credit', required — The reason for the adjustment.
    - `transaction_id` string, required — The id of the transaction for the adjustment.
  - `amount` integer, required — The deposited amount in USD cents.
  - `automatically_resolves_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Inbound Check Deposit will be automatically resolved if it has not been actioned by then.
  - `back_image_file_id` string, nullable, required — The ID for the File containing the image of the back of the check.
  - `bank_of_first_deposit_routing_number` string, nullable, required — The American Bankers' Association (ABA) Routing Transit Number (RTN) for the bank depositing this check. In some rare cases, this is not transmitted via Check21 and the value will be null.
  - `check_number` string, nullable, required — The check number printed on the check being deposited.
  - `check_transfer_id` string, nullable, required — If this deposit is for an existing Check Transfer, the identifier of that Check Transfer.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the deposit was attempted.
  - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the deposit.
  - `declined_at` string, date-time, nullable, required — If the Inbound Check Deposit was declined, the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which this took place.
  - `declined_transaction_id` string, nullable, required — If the deposit attempt has been rejected, the identifier of the Declined Transaction object created as a result of the failed deposit.
  - `deposit_return` object, nullable, required — If you requested a return of this deposit, this will contain details of the return.
    - `reason` 'altered_or_fictitious' | 'not_authorized' | 'duplicate_presentment' | 'endorsement_missing' | 'endorsement_irregular' | 'refer_to_maker', required — The reason the deposit was returned.
    - `returned_at` string, date-time, required — The time at which the deposit was returned.
    - `transaction_id` string, required — The id of the transaction for the returned deposit.
  - `front_image_file_id` string, nullable, required — The ID for the File containing the image of the front of the check.
  - `id` string, required — The deposit's identifier.
  - `payee_name_analysis` 'name_matches' | 'does_not_match' | 'not_evaluated', required — Whether the details on the check match the recipient name of the check transfer. This is an optional feature, contact sales to enable.
  - `status` 'pending' | 'accepted' | 'declined' | 'returned' | 'requires_attention', required — The status of the Inbound Check Deposit.
  - `transaction_id` string, nullable, required — If the deposit attempt has been accepted, the identifier of the Transaction object created as a result of the successful deposit.
  - `type` 'inbound_check_deposit', required — A constant representing the object's type. For this resource it will always be `inbound_check_deposit`.

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