--- title: "Show transaction" method: GET path: "/v2/transactions/{id}" tags: ["Transactions"] --- # Show transaction `GET /v2/transactions/{id}` OAuth scope: `organization.read` --- Retrieves a single transaction for a given bank account. --- The response contains a single transaction that contributed to the bank account's balances (e.g., incomes, transfers, cards). All transactions visible in Qonto's UI can be fetched, as of API V2. ## Path parameters - `id` string, required ## Query parameters - `includes[]` 'vat_details' | 'labels' | 'attachments' ## Headers - `X-Qonto-Staging-Token` string ## Response `200` Returns a transaction. - object - `transaction` Transaction - `id` string — UUID of the transaction. - `transaction_id` string - `amount` number, float — Amount of the transaction in the currency of the bank account. - `amount_cents` integer — Amount of the transaction in the currency of the bank account. - `settled_balance` number, nullable - `settled_balance_cents` integer, nullable - `attachment_ids` string[] — Array of UUIDs, corresponding to the attachments (up to 5) uploaded on the transaction. You can obtain details for each attachment using [Get attachment](/reference/openapi_v2.yml/paths/~1v2~1attachments~1%7Bid%7D/get). - `logo` object — Object containing URLs to small and medium-sized logos associated with the transaction. - `small` string - `medium` string - `local_amount` number, float — Amount of the transaction in the **foreign currency** (if any). - `local_amount_cents` integer — Amount of the transaction in the **foreign currency** (if any). - `side` string — - `credit`: incoming transaction - `debit`: outgoing transaction - `operation_type` string — - `income`: an incoming transfer - `transfer`: an outgoing transfer - `card`: a card payment - `direct_debit`: a SEPA Direct Debit (payments collected from you by other businesses) - `direct_debit_collection`: a SEPA Direct Debit Collection (payments collected from other businesses by you) - `direct_debit_hold`: a hold for a Direct Debit Collection, or its release - `qonto_fee`: a Qonto fee (subscription, atm withdrawal, fx card...) - `cheque`: a Check cashed on the account - `recall`: recall of an incoming transfer (by the emitter beneficiary or bank) - `swift_income`: a SWIFT incoming transfer - `pay_later`: a transaction related to financing - `financing_installment`: a transaction related to an installment of a financed transfer - `other`: an external transaction for which the type of transaction is unknown - `currency` string — `euros` is the only bank account currency supported by Qonto. - `local_currency` string - `label` string — Name of the counterparty of the transaction. - `clean_counterparty_name` string — Simplified and standardized version of the counterparty's name. - `settled_at` string, nullable — Date and time, in UTC, at which the transaction was finally committed to the account, and got set to a `completed` status.
Do note: the `settled_at` value can be `null`, for transaction which aren't `completed` (i.e. `pending`, `reversed` and `declined`). - `emitted_at` string — Date and time, in UTC, at which the transaction was first authorized and recorded on the bank account. - `updated_at` string — Date and time, in UTC, at which the transaction object was last updated (any state change will trigger a bump of this timestamp). - `status` string - `note` string, nullable - `reference` string, nullable - `vat_amount` number, float, nullable — Amount aggregate for all the VAT. - `vat_amount_cents` integer, nullable — Amount aggregate for all the VAT. - `vat_rate` number, float, nullable — Rate selected or detected. The value can be `-1` for uncategorized rate (e.g in France any value which is not in `0`, `2.1`, `5.5`, `10`, `20`) or for transactions with multiple VAT. - `initiator_id` string, nullable - `label_ids` string[] — `id` of the custom label that user can add on a transaction for categorization purposes. These labels are accessible using the [Show Label endpoint](https://api-doc.qonto.com/docs/business-api/b3A6ODQxOTQyMg-show-label). - `attachment_lost` boolean — Sets to `true` if the attachment of the transaction was marked as lost. - `attachment_required` boolean — Sets to `true` if the attachment of the transaction was marked as required. - `card_last_digits` string, nullable - `category` string — Possible values:
`restaurant_and_bar` `food_and_grocery` `transport` `gas_station` `hotel_and_lodging` `it_and_electronics` `hardware_and_equipment` `office_supply` `office_rental` `utility` `insurance` `logistics` `online_service` `legal_and_accounting` `finance` `tax` `salary` `marketing` `manufacturing` `atm` `other_service` `other_expense` `treasury_and_interco` `sales` `other_income` `refund` `fees` `subscription` `voucher` `fallback` `pending` - `subject_type` string — Identifies the type of transaction and maps to the nested additional fields with specific transaction data. Not to confuse with the attribute `operation_type` (explained above) which is a more specific categorisation of a transaction. Values: - `Card`: a card payment - `Transfer`: an outgoing transfer - `Income`: an incoming transfer - `DirectDebit`: a SEPA Direct Debit (payments collected from you by other businesses) - `DirectDebitCollection`: a SEPA Direct Debit Collection (payments collected from other businesses by you) - `DirectDebitHold`: a hold for a Direct Debit Collection, or its release - `WalletToWallet`: a transfer between two Qonto accounts - `Check`: a Check cashed on the account - `SwiftIncome`: a SWIFT incoming transfer - `PagopaPayment`: for electronic payments to central and local public administration entities - `F24Payment`: regulatory report in Italy that is used to pay taxes and social security to state entities - `BillingTransfer`: a transfer related to the billing of a Qonto account - `FinancingIncome`: financing for a transfer - `FinancingInstallment`: a repayment of the financing - `Other`: an external transaction for which the type of transaction is unknown For the subject types `DirectDebit`, `DirectDebitCollection`, `DirectDebitHold`, `Income`, `SwiftIncome`, `Transfer`, `Check`, `PagopaPayment` and `FinancingInstallment`, you will find a nested object (e.g. `direct_debit`) with additional fields. - `bank_account_id` string - `is_external_transaction` boolean — Sets to `true` for transactions related to external bank accounts (cf. https://support-fr.qonto.com/hc/en-us/articles/24231375285777-How-to-connect-my-external-accounts-to-my-Qonto-interface). - `attachments` object[], nullable — Use the following parameter to include `attachments` in the response: `includes[]=attachments`. - `id` string — UUID of the attachment. - `created_at` string - `file_name` string - `file_size` string - `file_content_type` string - `url` string - `probative_attachment` object - `status` string - `labels` object[] — Use the following parameter to include `labels` in the response: `includes[]=labels`. - `id` string — UUID of the label. - `name` string - `parent_id` string - `vat_details` object — Use the following parameter to include `vat_details` in the response: `includes[]=vat_details`. - `items` object[] — One item for each specific VAT line. - `amount` string - `amount_cents` string - `amount_excluding_vat` string - `amount_excluding_vat_cents` string - `rate` string — Rate selected or detected. The value can be `-1` for uncategorized rate (e.g in France any value which is not in `0, 2.1, 5.5, 10, 20`). - `transfer` object, nullable - `counterparty_account_number` string — Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_account_number_format` string — Account number format of the transaction’s counterparty. Possible values are: - `IBAN`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without IBAN**. - `counterparty_bank_identifier` string — Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_bank_identifier_format` string — Bank identifier format of the transaction’s counterparty. Possible values are: - `SWIFT_BIC`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without BIC**. - `income` object, nullable - `counterparty_account_number` string — Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_account_number_format` string — Account number format of the transaction’s counterparty. Possible values are: - `IBAN`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without IBAN**. - `counterparty_bank_identifier` string — Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_bank_identifier_format` string — Bank identifier format of the transaction’s counterparty. Possible values are: - `SWIFT_BIC`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without BIC**. - `swift_income` object, nullable - `counterparty_account_number` string — Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_account_number_format` string — Account number format of the transaction’s counterparty. Possible values are: - `unstructured`; - Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_bank_identifier` string — Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_bank_identifier_format` string — Bank identifier format of the transaction’s counterparty. Possible values are: - `sort_code`; - Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `direct_debit` object, nullable - `counterparty_account_number` string — Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_account_number_format` string — Account number format of the transaction’s counterparty. Possible values are: - `IBAN`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without IBAN**. - `counterparty_bank_identifier` string — Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when `is_external_transaction == true`). - `counterparty_bank_identifier_format` string — Bank identifier format of the transaction’s counterparty. Possible values are: - `SWIFT_BIC`; - Empty for external transaction (i.e. when `is_external_transaction == true`) **without BIC**. - `check` object, nullable - `check_number` string - `check_key` string - `financing_installment` object, nullable - `total_installments_number` integer — Installment of the current transaction. - `current_installment_number` integer — Total number of installments. - `pagopa_payment` object, nullable - `notice_number` string — Code in the PagoPA Payment Advice that identifies the payment notice, to be used for payments with PagoPA (i.e. codice_avviso). - `creditor_fiscal_code` string — Code in the PagoPA Payment Notice that identifies the creditor institution, to be used for PagoPA payments (i.e. codice_ent) - `iuv` string — Unique Payment Identifier (UPI) is the code that uniquely identifies exclusively a requested payment. - `direct_debit_collection` object, nullable - `counterparty_account_number` string — Account number of the transaction’s counterparty. - `counterparty_account_number_format` string — Account number format of the transaction’s counterparty. - `counterparty_bank_identifier` string — Bank identifier of the transaction’s counterparty. - `counterparty_bank_identifier_format` string — Bank identifier format of the transaction’s counterparty. - `direct_debit_hold` object, nullable - `guarding_rate` string ## Other responses - `404` — Returns a not found error. --- [API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)