--- 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). - `value` integer, required — The amount of the transaction, 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' | '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` CounterpartyV3, required - `balanceAccountId` string — The unique identifier of the counterparty [balance account](https://docs.adyen.com/api-explorer/balanceplatform/latest/post/balanceAccounts#responses-200-id). - `bankAccount` BankAccountV3 - `accountHolder` PartyIdentification, required - `address` Address - `city` string — The name of the city. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `country` string, required — The two-character ISO 3166-1 alpha-2 country code. For example, **US**, **NL**, or **GB**. - `line1` string — First line of the street address. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `line2` string — Second line of the street address. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `postalCode` string — The postal code. Maximum length: * 5 digits for an address in the US. * 10 characters for an address in all other countries. Supported characters: [a-z] [A-Z] [0-9] and Space. - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada. - `dateOfBirth` string, date — The date of birth of the individual in [ISO-8601](https://www.w3.org/TR/NOTE-datetime) format. For example, **YYYY-MM-DD**. Allowed only when `type` is **individual**. - `firstName` string — The first name of the individual. Supported characters: [a-z] [A-Z] - . / — and space. This parameter is: - Allowed only when `type` is **individual**. - Required when `category` is **card**. - `fullName` string — The full name of the entity that owns the bank account or card. Supported characters: [a-z] [A-Z] [0-9] , . ; : - — / \ + & ! ? @ ( ) " ' and space. Required when `category` is **bank**. - `lastName` string — The last name of the individual. Supported characters: [a-z] [A-Z] - . / — and space. This parameter is: - Allowed only when `type` is **individual**. - Required when `category` is **card**. - `reference` string — A unique reference to identify the party or counterparty involved in the transfer. For example, your client's unique wallet or payee ID. Required when you include `cardIdentification.storedPaymentMethodId`. - `type` 'individual' | 'organization' | 'unknown' — The type of entity that owns the bank account or card. Possible values: **individual**, **organization**, or **unknown**. Required when `category` is **card**. In this case, the value must be **individual**. - `accountIdentification` union, required — Contains the bank account details. The fields required in this object depend on the country of the bank account and the currency of the transfer. - AULocalAccountIdentification - `accountNumber` string, required — The bank account number, without separators or whitespace. - `bsbCode` string, required — The 6-digit [Bank State Branch (BSB) code](https://en.wikipedia.org/wiki/Bank_state_branch), without separators or whitespace. - `type` 'auLocal', required — **auLocal** - BRLocalAccountIdentification - `accountNumber` string, required — The bank account number, without separators or whitespace. - `bankCode` string, required — The 3-digit bank code, with leading zeros. - `branchNumber` string, required — The bank account branch number, without separators or whitespace. - `ispb` string — The 8-digit ISPB, with leading zeros. - `type` 'brLocal', required — **brLocal** - CALocalAccountIdentification - `accountNumber` string, required — The 5- to 12-digit bank account number, without separators or whitespace. - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**. - `institutionNumber` string, required — The 3-digit institution number, without separators or whitespace. - `transitNumber` string, required — The 5-digit transit number, without separators or whitespace. - `type` 'caLocal', required — **caLocal** - CZLocalAccountIdentification - `accountNumber` string, required — The 2- to 16-digit bank account number (Číslo účtu) in the following format: - The optional prefix (předčíslí). - The required second part (základní část) which must be at least two non-zero digits. Examples: - **19-123457** (with prefix) - **123457** (without prefix) - **000019-0000123457** (with prefix, normalized) - **000000-0000123457** (without prefix, normalized) - `bankCode` string, required — The 4-digit bank code (Kód banky), without separators or whitespace. - `type` 'czLocal', required — **czLocal** - DKLocalAccountIdentification - `accountNumber` string, required — The 4-10 digits bank account number (Kontonummer) (without separators or whitespace). - `bankCode` string, required — The 4-digit bank code (Registreringsnummer) (without separators or whitespace). - `type` 'dkLocal', required — **dkLocal** - HKLocalAccountIdentification - `accountNumber` string, required — The 9- to 15-character bank account number (alphanumeric), without separators or whitespace. Starts with the 3-digit branch code. - `clearingCode` string, required — The 3-digit clearing code, without separators or whitespace. - `type` 'hkLocal', required — **hkLocal** - HULocalAccountIdentification - `accountNumber` string, required — The 24-digit bank account number, without separators or whitespace. - `type` 'huLocal', required — **huLocal** - IbanAccountIdentification - `iban` string, required — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard. - `type` 'iban', required — **iban** - NOLocalAccountIdentification - `accountNumber` string, required — The 11-digit bank account number, without separators or whitespace. - `type` 'noLocal', required — **noLocal** - NZLocalAccountIdentification - `accountNumber` string, required — The 15-16 digit bank account number. The first 2 digits are the bank number, the next 4 digits are the branch number, the next 7 digits are the account number, and the final 2-3 digits are the suffix. - `type` 'nzLocal', required — **nzLocal** - NumberAndBicAccountIdentification - `accountNumber` string, required — The bank account number, without separators or whitespace. The length and format depends on the bank or country. - `additionalBankIdentification` AdditionalBankIdentification - `code` string — The value of the additional bank identification. - `type` 'gbSortCode' | 'usRoutingNumber' — The type of additional bank identification, depending on the country. Possible values: * **gbSortCode**: The 6-digit [UK sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or spaces * **usRoutingNumber**: The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or spaces. - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code. - `type` 'numberAndBic', required — **numberAndBic** - PLLocalAccountIdentification - `accountNumber` string, required — The 26-digit bank account number ([Numer rachunku](https://pl.wikipedia.org/wiki/Numer_Rachunku_Bankowego)), without separators or whitespace. - `type` 'plLocal', required — **plLocal** - SELocalAccountIdentification - `accountNumber` string, required — The 7- to 10-digit bank account number ([Bankkontonummer](https://sv.wikipedia.org/wiki/Bankkonto)), without the clearing number, separators, or whitespace. - `clearingNumber` string, required — The 4- to 5-digit clearing number ([Clearingnummer](https://sv.wikipedia.org/wiki/Clearingnummer)), without separators or whitespace. - `type` 'seLocal', required — **seLocal** - SGLocalAccountIdentification - `accountNumber` string, required — The 4- to 19-digit bank account number, without separators or whitespace. - `bic` string, required — The bank's 8- or 11-character BIC or SWIFT code. - `type` 'sgLocal' — **sgLocal** - UKLocalAccountIdentification - `accountNumber` string, required — The 8-digit bank account number, without separators or whitespace. - `sortCode` string, required — The 6-digit [sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or whitespace. - `type` 'ukLocal', required — **ukLocal** - USLocalAccountIdentification - `accountNumber` string, required — The bank account number, without separators or whitespace. - `accountType` 'checking' | 'savings' — The bank account type. Possible values: **checking** or **savings**. Defaults to **checking**. - `routingNumber` string, required — The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or whitespace. - `type` 'usLocal', required — **usLocal** - `card` Card - `cardHolder` PartyIdentification, required - `address` Address - `city` string — The name of the city. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `country` string, required — The two-character ISO 3166-1 alpha-2 country code. For example, **US**, **NL**, or **GB**. - `line1` string — First line of the street address. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `line2` string — Second line of the street address. Supported characters: [a-z] [A-Z] [0-9] . - — / # , ’ ° ( ) : ; [ ] & \ | and Space. - `postalCode` string — The postal code. Maximum length: * 5 digits for an address in the US. * 10 characters for an address in all other countries. Supported characters: [a-z] [A-Z] [0-9] and Space. - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada. - `dateOfBirth` string, date — The date of birth of the individual in [ISO-8601](https://www.w3.org/TR/NOTE-datetime) format. For example, **YYYY-MM-DD**. Allowed only when `type` is **individual**. - `firstName` string — The first name of the individual. Supported characters: [a-z] [A-Z] - . / — and space. This parameter is: - Allowed only when `type` is **individual**. - Required when `category` is **card**. - `fullName` string — The full name of the entity that owns the bank account or card. Supported characters: [a-z] [A-Z] [0-9] , . ; : - — / \ + & ! ? @ ( ) " ' and space. Required when `category` is **bank**. - `lastName` string — The last name of the individual. Supported characters: [a-z] [A-Z] - . / — and space. This parameter is: - Allowed only when `type` is **individual**. - Required when `category` is **card**. - `reference` string — A unique reference to identify the party or counterparty involved in the transfer. For example, your client's unique wallet or payee ID. Required when you include `cardIdentification.storedPaymentMethodId`. - `type` 'individual' | 'organization' | 'unknown' — The type of entity that owns the bank account or card. Possible values: **individual**, **organization**, or **unknown**. Required when `category` is **card**. In this case, the value must be **individual**. - `cardIdentification` CardIdentification, required - `expiryMonth` string — The expiry month of the card. Format: two digits. Add a leading zero for single-digit months. For example: * 03 = March * 11 = November - `expiryYear` string — The expiry year of the card. Format: four digits. For example: 2020 - `issueNumber` string — The issue number of the card. Applies only to some UK debit cards. - `number` string — The card number without any separators. For security, the response only includes the last four digits of the card number. - `startMonth` string — The month when the card was issued. Applies only to some UK debit cards. Format: two digits. Add a leading zero for single-digit months. For example: * 03 = March * 11 = November - `startYear` string — The year when the card was issued. Applies only to some UK debit cards. Format: four digits. For example: 2020 - `storedPaymentMethodId` string — The unique [token](/payouts/payout-service/pay-out-to-cards/manage-card-information#save-card-details) created to identify the counterparty. - `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 counterparty [transfer instrument](https://docs.adyen.com/api-explorer/legalentity/latest/post/transferInstruments#responses-200-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, **2020-12-18T10:15:30+01:00**. - `description` string — The `description` from the `/transfers` request. - `eventId` string — The PSP reference of the transaction in the journal. - `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). - `value` integer, required — The amount of the transaction, 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' | '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 - **2024-07-31** (v3) `ebb1e0fcae2e` — 1 breaking, 1 info - the response property `counterparty/bankAccount/accountHolder/fullName` became optional for the status `200` - added the optional property `counterparty/card` to the response with the `200` status - **2024-07-17** (v3) `896c666a5ba4` — 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** (v3) `1556197141af` — 17 warning, 1 info - removed the optional property `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/AULocalAccountIdentification]/formFactor` from the response with the `200` status - removed the optional property `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/BRLocalAccountIdentification]/formFactor` from the response with the `200` status - removed the optional property `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/CALocalAccountIdentification]/formFactor` from the response with the `200` status - removed the optional property `counterparty/bankAccount/accountIdentification/oneOf[#/components/schemas/CZLocalAccountIdentification]/formFactor` from the response with the `200` status - …14 more - …earlier changes not shown [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/bc888fe170cf/schema)