---
title: "ach/failures"
method: GET
path: "/ach/failures"
tags: ["ACH Endpoints"]
---

# ach/failures

`GET /ach/failures`

This endpoint is used to retrieve a list of transactions which failed during a specific date range. This endpoint is queried based on the date that a failure occurred on, not on the date when the transaction originally occurred.

## Query parameters

- `AccountID` string, required
- `Key` string, required
- `Signature` string, required
- `StartDateTime` string, date-time, required
- `EndDateTime` string, date-time, required

## Response `200`

- object
  - `Success` boolean, required — True if the request was successful, false if it failed
  - `ErrorMessage` string, required — Contains a description of the error if the request failed
  - `NumberOfRecords` number, required — Total number of failed transaction records returned
  - `FailedTransactions` object, required — Array serialized as a JSON object (JSON_FORCE_OBJECT): numeric string keys '0','1',... Collection of TransactionInfo data
    - `0` object
      - `TransactionID` integer, required — Unique ID for the Transaction
      - `TransactionDateTime` string, date-time, required — The timestamp on which the transaction occurred.
      - `TransactionType` string, required — Specifies the type of transaction, for example 'ACH Funding', 'ACH Withdrawal'.
      - `DollarAmount` number, required — The dollar amount of the failed transaction.
      - `ErrorCode` string, required — Detail error code of the failure.
      - `FailureReason` string, required — Detailed description of why the transaction failed. Transactions which have failed cannot be modified, a new fund or withdraw transaction must be created if you wish to re-attempt the transaction.
      - `ClientReferenceNumber` string, required — The optional reference number which was set when the transaction was created.

---

[API](https://skmtc.net/vopay/apis/accounts.md) · [All operations](https://skmtc.net/vopay/apis/accounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vopay/accounts/versions/7033bd231ec7/schema)