---
title: "/claim/intake/retrieveTransactions"
method: POST
path: "/claim/intake/retrieveTransactions"
tags: ["Intake"]
---

# /claim/intake/retrieveTransactions

`POST /claim/intake/retrieveTransactions`

## Request

- Base URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0`
- URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0/claim/intake/retrieveTransactions`
- Auth: none declared

Use this endpoint to retrieve transactions that can be selected to add to the claim. Using the customer ID, account number, and submitted claim reasons to retrieve valid transactions.

A default date range is built into the dispute system, so most inputs are optional.

This API can be called multiple times if ad-hoc searching
is being performed.

Prerequisite API call: 
- `/claim/intake/addClaimReasons`

## Request body

- object
  - `SearchAccountNumber` number: Account number for searching for transactions that are on a different account than the claim. **Required** only if the user needs to add transactions to the claim that are on a different account than the claim's disputed transactions.
  - `SearchStartDate` string: Search start date for date range search. **Required** only if the user is searching for transactions within a certain date range Format: yyyyMMdd
  - `SearchEndDate` string: Search end date for date range search. **Required** only if the user is searching for transactions within a certain date range Format: yyyyMMdd
  - `SearchAmount` string: Transaction amount to search for. **Required** only if the user is searching for a transaction with a specific amount.
  - `SearchMerchantName` string: Merchant name/Transaction description to search for. **Required** only if the user is searching for a transaction with a specific merchant

## Response `200`

postRetrieveTransactions

- object
  - `TransactionList` object[]
    - `Amount` string: Amount of transaction
    - `AmountInfo` object
      - `Amount` string: Amount of currency
      - `Exponent` string: Number of decimal places for currency
      - `ISOCodeAlpha` string: 3 character alpha iso code
      - `ISOCodeNumeric` string: numeric iso code
      - `ISOCurrencyName` string: currency name
    - `AuthorizationStatus` 'Pending' | 'Posted': Authorization status of the transaction
    - `CardNumberEndingIn` string: Last 4 digits of card number
    - `Date` string: Date of transaction in yyyyMMdd formatted string
    - `DebitCredit` 'Debit' | 'Credit': Debit or Credit
    - `Description` string: Transaction description/Merchant name
    - `PostingDateTime` string: The posting timestamp of format yyyyMMdd'T'HHmmss.SSS z
    - `SelectMode` 'Multi' | 'Single': The selection mode for the transaction. * `Multi` — Multiple transactions can be selected for this claim type. * `Single` — Only one transaction can be selected for this claim type.
    - `TransactionDateTime` string: The authorization timestamp of format yyyyMMdd'T'HHmmss.SSS z
    - `TransactionId` string: ID for the disputed transaction: `P[prog_id]|[prn]|[auth_id]|[network_code]|[trans_code]` Example: `P111|999123456789|0169|M|AUA`
    - `TransactionType` 'ACH' | 'ATMDEP' | 'ATMWD' | 'CardPinless' | 'CardPinned' | 'CHECK' | 'FEE' | 'P2P' | 'WIRE': Type of the transaction
  - `StatusList` object[]
    - `Type` 'Error' | 'Success': Status of the request
    - `Message` string: Message about the status
    - `Code` string: Numeric code for the status
  - `rtoken` string, nullable: A system-generated ID used for tracking
  - `StatusCode` integer, nullable: The HTTP response status code

## Other responses

- `202`: Transaction Selection Unavailable<br /><br />This is a response for claim types that do not support transaction selection. This is configurable by the client, but by default the dispute system will set this to true for ClaimReasons **ATMDepNotPosted, FraudApp, MerchantNonReceiptFunds, NonFraudMissing**.
- `203`: Transaction Selection Optional<br /><br />This is configurable by the client, but by default the dispute system will set this to true for (Card Claims ClaimReason **ATMDep**) or ClaimReason **ATMDepNotPosted** or (Deposit Claims and ClaimReasonTypes **NonFraud, NonFraudMissing, NonFraudRevoked**) or ClaimReasonTypes **AuthChargeback, FraudAccountIssue**.
- `400`: Error retrieve transactions request
- `500`: Error retrieve transactions request

---

[API](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/revisions/cf13cabe7c95?raw)