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

# Get a transaction

`GET /transactions/{id}`

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).
    - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
  - `balanceAccountId` string, required — Unique identifier of the balance account.
  - `balancePlatform` string, required — Unique identifier of the balance platform.
  - `bookingDate` string, date-time, required — The date the transaction was booked to the balance account.
  - `category` 'bank' | 'grants' | 'internal' | 'issuedCard' | 'platformPayment' — 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 — 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
      - `mcc` string — The merchant category code.
      - `merchantId` string — The merchant identifier.
      - `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 merchant postal code.
    - `transferInstrumentId` string — 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.
  - `description` string — The `description` from the `/transfers` request.
  - `id` string, required — Unique identifier of the transaction.
  - `instructedAmount` Amount
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
    - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
  - `paymentInstrumentId` string — 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' | 'balanceRollover' | 'bankTransfer' | 'capture' | 'captureReversal' | 'chargeback' | 'chargebackReversal' | 'depositCorrection' | 'directDebit' | 'fee' | 'grant' | 'installment' | 'installmentReversal' | 'internalTransfer' | 'invoiceDeduction' | 'leftover' | 'manualCorrection' | 'miscCost' | 'payment' | 'paymentCost' | 'refund' | 'refundReversal' | 'repayment' | 'reserveAdjustment' | 'secondChargeback' — 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

- **2023-01-10** (v1) `2cb4e0690ae2` — 1 warning
  - added the new `balanceRollover` enum value to the `type` response property for the response status `200`
- **2022-11-28** (v1) `02d77153ae6b` — 1 warning, 1 info
  - added the new `directDebit` enum value to the `type` response property for the response status `200`
  - the response required property `id` became not read-only for the status `200`
- **2022-10-04** (v1) `5050c5535aca` — 4 breaking, 1 warning
  - the response property `instructedAmount` became optional for the status `200`
  - the response property `paymentInstrumentId` became optional for the status `200`
  - the response property `referenceForBeneficiary` became optional for the status `200`
  - the response property `transferId` became optional for the status `200`
  - …1 more
- **2022-09-07** (v1) `4a2a50ba39a0` — 1 warning
  - added the new `installmentReversal` enum value to the `type` response property for the response status `200`
- **2022-09-02** (v1) `a6fcc469131a` — 1 info
  - endpoint added

[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/2cb4e0690ae2/schema)