---
title: "Get a transaction"
method: GET
path: "/transactions/{id}"
tags: ["Transactions"]
---

# Get a transaction

`GET /transactions/{id}`

>Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.

Returns a transaction.

## Path parameters

- `id` string, required

## Response `200`

OK - the request has succeeded.

- Transaction
  - `accountHolderId` string, required — Unique identifier of the account holder.
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `balanceAccountId` string, required — Unique identifier of the balance account.
  - `balancePlatform` string, required — The unique identifier of the balance platform.
  - `bookingDate` string, date-time, required — The date the transaction was booked into the balance account.
  - `category` 'bank' | 'card' | 'grants' | 'interest' | 'internal' | 'issuedCard' | 'migration' | 'platformPayment' | 'topUp' | 'upgrade' — The category of the transaction indicating the type of activity. Possible values: * **platformPayment**: The transaction is a payment or payment modification made with an Adyen merchant account. * **internal**: The transaction resulted from an internal adjustment such as a deposit correction or invoice deduction. * **bank**: The transaction is a bank-related activity, such as sending a payout or receiving funds. * **issuedCard**: The transaction is a card-related activity, such as using an Adyen-issued card to pay online.
  - `counterparty` Counterparty, required
    - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
    - `bankAccount` BankAccountInfo
      - `address` Address
        - `city` string, required — The name of the city. Maximum length: 3000 characters.
        - `country` string, required — The two-character ISO-3166-1 alpha-2 country code. For example, **US**. > If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`.
        - `houseNumberOrName` string, required — The number or name of the house. Maximum length: 3000 characters.
        - `postalCode` string, required — A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries.
        - `stateOrProvince` string — The two-character ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
        - `street` string, required — The name of the street. Maximum length: 3000 characters. > The house number should not be included in this field; it should be separately provided via `houseNumberOrName`.
      - `iban` string — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
      - `ownerName` Name
        - `firstName` string — The first name.
        - `fullName` string — The full name.
        - `infix` string — The infix in the name, if any.
        - `lastName` string — The last name.
    - `merchant` MerchantData
      - `acquirerId` string — The unique identifier of the merchant's acquirer.
      - `mcc` string — The merchant category code.
      - `merchantId` string — The unique identifier of the merchant.
      - `nameLocation` NameLocation
        - `city` string — The city where the merchant is located.
        - `country` string — The country where the merchant is located in [three-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format.
        - `countryOfOrigin` string — The home country in [three-digit country code](https://en.wikipedia.org/wiki/ISO_3166-1_numeric) format, used for government-controlled merchants such as embassies.
        - `name` string — The name of the merchant's shop or service.
        - `rawData` string — The raw data.
        - `state` string — The state where the merchant is located.
      - `postalCode` string — The postal code of the merchant.
    - `transferInstrumentId` string — The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/transferInstruments__resParam_id).
  - `createdAt` string, date-time, required — The date the transaction was created.
  - `creationDate` string, date-time — The date and time when the event was triggered, in ISO 8601 extended format. For example, **2025-03-19T10:15:30+01:00**.
  - `description` string — The `description` from the `/transfers` request.
  - `id` string, required — The unique identifier of the transaction.
  - `instructedAmount` Amount
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `paymentInstrumentId` string — The unique identifier of the payment instrument that was used for the transaction.
  - `reference` string, required — The [`reference`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_reference) from the `/transfers` request. If you haven't provided any, Adyen generates a unique reference.
  - `referenceForBeneficiary` string — The reference sent to or received from the counterparty. * For outgoing funds, this is the [`referenceForBeneficiary`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__resParam_referenceForBeneficiary) from the [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_referenceForBeneficiary) request. * For incoming funds, this is the reference from the sender.
  - `status` 'booked' | 'pending', required — The status of the transaction. Possible values: * **pending**: The transaction is still pending. * **booked**: The transaction has been booked to the balance account.
  - `transferId` string — Unique identifier of the related transfer.
  - `type` 'atmWithdrawal' | 'atmWithdrawalReversal' | 'balanceAdjustment' | 'balanceMigration' | 'balanceRollover' | 'bankDirectDebit' | 'bankTransfer' | 'capitalFundsCollection' | 'capture' | 'captureReversal' | 'cardTransfer' | 'cashOutFee' | 'cashOutFunding' | 'cashOutInstruction' | 'cashoutFee' | 'cashoutFunding' | 'cashoutRepayment' | 'chargeback' | 'chargebackCorrection' | 'chargebackReversal' | 'chargebackReversalCorrection' | 'depositCorrection' | 'fee' | 'grant' | 'installment' | 'installmentReversal' | 'interestPayout' | 'internalDirectDebit' | 'internalTransfer' | 'invoiceDeduction' | 'leftover' | 'manualCorrection' | 'miscCost' | 'payment' | 'paymentCost' | 'refund' | 'refundReversal' | 'repayment' | 'reserveAdjustment' | 'secondChargeback' | 'secondChargebackCorrection' — The type of the transaction. Possible values: **payment**, **capture**, **captureReversal**, **refund** **refundReversal**, **chargeback**, **chargebackReversal**, **secondChargeback**, **atmWithdrawal**, **atmWithdrawalReversal**, **internalTransfer**, **manualCorrection**, **invoiceDeduction**, **depositCorrection**, **bankTransfer**, **miscCost**, **paymentCost**, **fee**
  - `valueDate` string, date-time, required — The date the transfer amount becomes available in the balance account.

## Other responses

- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2025-05-21** (v1) `7d50c61d15a0` — 2 warning
  - added the new `interest` enum value to the `category` response property for the response status `200`
  - added the new `interestPayout` enum value to the `type` response property for the response status `200`
- **2024-07-17** (v1) `442da14d7ff0` — 3 warning
  - added the new `cashoutFee` enum value to the `type` response property for the response status `200`
  - added the new `cashoutFunding` enum value to the `type` response property for the response status `200`
  - added the new `cashoutRepayment` enum value to the `type` response property for the response status `200`
- **2024-05-02** (v1) `3cbb09de4cb8` — 1 warning
  - added the new `capitalFundsCollection` enum value to the `type` response property for the response status `200`
- **2024-03-04** (v1) `2b890cadd368` — 2 warning
  - added the new `bankDirectDebit` enum value to the `type` response property for the response status `200`
  - added the new `internalDirectDebit` enum value to the `type` response property for the response status `200`
- **2023-12-20** (v1) `b6626bee4e9b` — 1 warning, 1 info
  - added the new `topUp` enum value to the `category` response property for the response status `200`
  - the endpoint scheme security `clientKey` was added to the API

[Full history](https://skmtc.dev/adyen/apis/transferservice/changes/transactions/:id/get.md)

---

[API](https://skmtc.dev/adyen/apis/transferservice.md) · [All operations](https://skmtc.dev/adyen/apis/transferservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/transferservice/revisions/13735824b8e3/schema)