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

# /claim/intake/retrieveSimilarTransactions

`POST /claim/intake/retrieveSimilarTransactions`

## 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/retrieveSimilarTransactions`
- Auth: none declared

Use this endpoint to get a list of similar transactions within search criteria that can be selected to add to the claim.

`SearchAccountNumber` is **required** if the customer identified that the transaction was on a different account than the claim. Get other valid account numbers by calling `/claim/intake/retrieveOtherAccounts`.

Requires a question response indicating in `APIDocumentationList` that this method is required.

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

## Request body

- object
  - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
  - `ClaimId` string, required: Unique claim ID
  - `SearchAccountNumber` string: Account number to search for if different than selected account on claim **Required** only if the user is searching for a transaction on a different account than the account on the claim.
  - `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`

postRetrieveSimilarTransactions

- 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

- `400`: Error retrieve similar transactions request
- `500`: Error retrieve similar 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)