---
title: "Get Deposit History"
method: POST
path: "/getDepositHistory"
tags: ["Transactions"]
---

# Get Deposit History

`POST /getDepositHistory`

Use the Get Deposit History endpoint to retrieve deposit history for either your entire program or for a specified customer. Omit the `accountNo` parameter to get the history for your entire program.

See <a href="ref:record-set-paging" target="_blank">Record-Set Pagination</a> for instructions on using the paging parameters.

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[] — A list of errors generated while the request was processed
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `deposit_count` integer, required — The number of deposits in the response
    - `page` integer, required — The page number to be retrieved in the context of recordset paging
    - `total_record_count` integer, required — Total number of deposit records returned
    - `number_of_pages` integer, required — Total number of pages
    - `start_date` string, date, required — The start date for deposit records
    - `end_date` string, date, required — The end date for deposit records
    - `deposits` object[], required
      - `amt` string, nullable, required — The amount of the deposit
      - `in_ts` string, date-time, required — Timestamp for the initial creation of the record
      - `effective_dt` string, date-time, nullable, required — Date when the ACH payment posts
      - `name` string, nullable, required — The name of the account receiving the deposit
      - `efname` string, nullable — Encrypted cardholder first name
      - `elname` string, nullable — Encrypted cardholder last name
      - `xid` string, nullable — An account ID that can be used instead of the PAN
      - `prog_id` string, nullable, required — Identifier for the program associated with the account
      - `batch_hdr` string, nullable — A record of a batch of transactions
      - `company_entry_description` string, nullable — Value of Company Entry Description from the Company/Batch Header Record in ach file
      - `company_identification` string, nullable — Value of Company Identification from the Company/Batch Header Record in ach file
      - `dest_acct_no` string, nullable — The destination account for a pending deposit
      - `source_inst_id` string, nullable, required — An ID (usually a bank routing number) for the institution that originated the deposit
      - `source_inst_name` string, nullable, required — The name of the institution that originated the deposit
      - `source_acct_no` string, nullable — An account number of the institution that originated the deposit
      - `status` string, nullable, required — The status of the deposit. See <a href="ref:api-reference-deposit-status-codes" target="_blank">Deposit Status Codes</a>.
      - `trans_type` string, nullable, required — Transaction type
      - `addenda_rec` string, nullable — Supplemental information to identify a deposit
      - `ach_trans_id` string, required — A unique ID for an ACH transaction
      - `pmt_ref_no` string, nullable — <a href="doc:about-accounts#prn" target="_blank">Payment reference number</a>.
      - `ach_category` string, nullable — Transaction ACH category
      - `ach_subcategory` string, nullable — Transaction ACH subcategory
      - `trans_ts` string, date-time, nullable — Original settlement date
      - `actual_settl_dt` string, date-time, nullable — Actual settlement date
      - `ach_early_days_used` number, nullable — Number of Early Days Used
      - `categories` object[]
        - `ach_source_id` string, nullable, required — An identifier for the <<glossary:ODFI>>
        - `category_code` string, required — Category code for the deposit. See <a href="ref:api-reference-deposit-category-codes" target="_blank">Deposit Category Codes</a> for valid values.
        - `description` string, required — Description of the record
        - `last_updated` string — Indicates when the `source_status` was last updated
        - `last_updated_by` string, nullable — Indicates who last updated the `source_status`
        - `source_status` string — The source status for the ACH request. Possible values are `APPROVE`, `WATCH`, or `DECLINE`
        - `status` string, nullable — The deposit status. See <a href="ref:api-reference-deposit-status-codes">Deposit Status Codes</a> for possible values.

---

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