curl --request GET \
--url https://thirdparty.qonto.com/v2/transactions/{id} \
--header 'Authorization: Bearer <token>'{
"transaction": {
"transaction_id": "super-transaction-6576",
"amount": 52.4,
"amount_cents": 5240,
"settled_balance": 111.1,
"settled_balance_cents": 11110,
"attachment_ids": [],
"local_amount": 52.4,
"local_amount_cents": 5240,
"side": "debit",
"operation_type": "transfer",
"currency": "EUR",
"local_currency": "EUR",
"label": "Stamm and Sons",
"settled_at": "2021-03-14T17:17:02.000Z",
"emitted_at": "2021-03-06T12:33:13.000Z",
"created_at": "2021-03-06T12:33:13.000Z",
"updated_at": "2021-03-21T21:32:03.000Z",
"status": "completed",
"note": "Jacynthe Kuhic",
"reference": null,
"vat_amount": null,
"vat_amount_cents": null,
"vat_rate": null,
"initiator_id": "6e5468a1-22ad-4974-bf9f-45652511d39c",
"label_ids": [
"872a75d8-b85c-467e-b8f0-091ea48ef68f"
],
"attachment_lost": false,
"attachment_required": true,
"card_last_digits": "1234",
"category": "gas_station",
"cashflow_category": {
"name": "Others"
},
"cashflow_subcategory": {
"name": "Tips"
},
"id": "7b7a5ed6-3903-4782-889d-b4f64bd7bef9",
"attachments": [
{
"id": "ea54f563-eaee-4dcb-b08e-688dc9937d23",
"created_at": "2021-03-18T11:52:07.000Z",
"file_name": "Foobar",
"file_size": "666",
"file_content_type": "image/png",
"url": "https://qonto-dev.s3.eu-central-1.amazonaws.com/test/uploads/attachment/ea54f563-eaee-4dcb-b08e-688dc9937d23/%23%3CRack%3A%3ATest%3A%3AUploadedFile%3A0x00005635fc7cf8e8%3E?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZ4DSTCECB4IXGFVF%2F20210521%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210521T080955Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=b6b8977aff8529018d15a05f3e36cc5b59e325d675b6538ff55005aa8e2eb3ed",
"probative_attachment": {
"status": "unavailable"
}
}
],
"labels": [
{
"id": "211e69c1-f27f-4b45-a623-bec44a715ee7",
"name": "Durable Silk Table",
"parent_id": null
}
],
"subject_type": "transfer",
"transfer": {
"counterparty_account_number": "NL93RABO3730976796",
"counterparty_account_number_format": "IBAN",
"counterparty_bank_identifier": "RABO",
"counterparty_bank_identifier_format": "SWIFT_BIC"
}
}
}Retrieve a transaction
OAuth scope: organization.read
Retrieves the transaction identified by the id path parameter.
curl --request GET \
--url https://thirdparty.qonto.com/v2/transactions/{id} \
--header 'Authorization: Bearer <token>'{
"transaction": {
"transaction_id": "super-transaction-6576",
"amount": 52.4,
"amount_cents": 5240,
"settled_balance": 111.1,
"settled_balance_cents": 11110,
"attachment_ids": [],
"local_amount": 52.4,
"local_amount_cents": 5240,
"side": "debit",
"operation_type": "transfer",
"currency": "EUR",
"local_currency": "EUR",
"label": "Stamm and Sons",
"settled_at": "2021-03-14T17:17:02.000Z",
"emitted_at": "2021-03-06T12:33:13.000Z",
"created_at": "2021-03-06T12:33:13.000Z",
"updated_at": "2021-03-21T21:32:03.000Z",
"status": "completed",
"note": "Jacynthe Kuhic",
"reference": null,
"vat_amount": null,
"vat_amount_cents": null,
"vat_rate": null,
"initiator_id": "6e5468a1-22ad-4974-bf9f-45652511d39c",
"label_ids": [
"872a75d8-b85c-467e-b8f0-091ea48ef68f"
],
"attachment_lost": false,
"attachment_required": true,
"card_last_digits": "1234",
"category": "gas_station",
"cashflow_category": {
"name": "Others"
},
"cashflow_subcategory": {
"name": "Tips"
},
"id": "7b7a5ed6-3903-4782-889d-b4f64bd7bef9",
"attachments": [
{
"id": "ea54f563-eaee-4dcb-b08e-688dc9937d23",
"created_at": "2021-03-18T11:52:07.000Z",
"file_name": "Foobar",
"file_size": "666",
"file_content_type": "image/png",
"url": "https://qonto-dev.s3.eu-central-1.amazonaws.com/test/uploads/attachment/ea54f563-eaee-4dcb-b08e-688dc9937d23/%23%3CRack%3A%3ATest%3A%3AUploadedFile%3A0x00005635fc7cf8e8%3E?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZ4DSTCECB4IXGFVF%2F20210521%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20210521T080955Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=b6b8977aff8529018d15a05f3e36cc5b59e325d675b6538ff55005aa8e2eb3ed",
"probative_attachment": {
"status": "unavailable"
}
}
],
"labels": [
{
"id": "211e69c1-f27f-4b45-a623-bec44a715ee7",
"name": "Durable Silk Table",
"parent_id": null
}
],
"subject_type": "transfer",
"transfer": {
"counterparty_account_number": "NL93RABO3730976796",
"counterparty_account_number_format": "IBAN",
"counterparty_bank_identifier": "RABO",
"counterparty_bank_identifier_format": "SWIFT_BIC"
}
}
}Authorizations
Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Headers
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Path Parameters
UUID of the transaction to retrieve.
"7b7a5ed6-3903-4782-889d-b4f64bd7bef9"
Query Parameters
Use this parameter to embed the associated resources (labels, attachments and/or VAT details) of the transactions in the JSON response.
vat_details, labels, attachments Response
Returns the transaction identified by the id path parameter.
Show child attributes
Show child attributes
UUID of the transaction.
Amount of the transaction in the currency of the bank account.
"10,00"
Amount of the transaction in the currency of the bank account.
1000
The account balance at the moment the transaction was settled. Might be empty for external transaction (i.e. when is_external_transaction == true).
The account balance at the moment the transaction was settled. Might be empty for external transaction (i.e. when is_external_transaction == true).
Array of UUIDs, corresponding to the attachments (up to 5) uploaded on the transaction. You can obtain details for each attachment using Get attachment.
Amount of the transaction in the foreign currency (if any).
"10,87"
Amount of the transaction in the foreign currency (if any).
1087
credit: incoming transactiondebit: outgoing transaction
Available options:
income: an incoming transfertransfer: an outgoing transfercard: a card paymentcard_acquirer_payout: a daily payout transaction from Tap to Pay card paymentsdirect_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 releaseqonto_fee: a Qonto fee (subscription, atm withdrawal, fx card...)cheque: a check cashed on the accountrecall: recall of an incoming transfer (by the emitter beneficiary or bank)swift_income: a SWIFT incoming transferpay_later: a transaction related to financingfinancing_installment: a transaction related to an installment of a financed transferaccount_remuneration: earnings paid by Qonto based on your account balance and transaction historyf24: a tax payment transaction to Italian government agencies using the F24 formpagopa_payment: a payment transaction to Italian public institutions or utility companies via PagoPAnrc_payment: a tax payment transaction to Spanish tax authorities (AEAT) with NRC referenceriba_payment: a payment transaction from a supplier's payment request (Italian market)other: an external transaction for which the type of transaction is unknown
euros is the only bank account currency supported by Qonto.
"USD"
Name of the counterparty of the transaction.
Simplified and standardized version of the counterparty's name.
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).
Date and time, in UTC, at which the transaction was first authorized and recorded on the bank account.
Date and time, in UTC, at which the transaction was created.
Date and time, in UTC, at which the transaction object was last updated (any state change will trigger a bump of this timestamp).
Amount aggregate for all the VAT.
Amount aggregate for all the VAT.
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.
10
id of the custom label that user can add on a transaction for categorization purposes. These labels are accessible using the GET /v2/labels/{id} endpoint.
Sets to true if the attachment of the transaction was marked as lost.
Sets to true if the attachment of the transaction was marked as required.
This field is deprecated and is no longer shown in the UI. Please use cashflow_category and cashflow_subcategory instead. 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
Identifies the type of transaction and maps to the nested additional fields with specific transaction data. Not to confuse with the property operation_type (explained above) which is a more specific categorisation of a transaction.
Values:
Card: a card paymentTransfer: an outgoing transferIncome: an incoming transferDirectDebit: 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 releaseWalletToWallet: a transfer between two Qonto accountsCheck: a Check cashed on the accountSwiftIncome: a SWIFT incoming transferPagopaPayment: for electronic payments to central and local public administration entitiesF24Payment: regulatory report in Italy that is used to pay taxes and social security to state entitiesBillingTransfer: a transfer related to the billing of a Qonto accountFinancingIncome: financing for a transferFinancingInstallment: a repayment of the financingAccountRemuneration: earnings paid by Qonto based on your account balance and transaction historyOther: 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.
For subject type account_remuneration you will not find any extra nested objects.
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).
Use the following parameter to include attachments in the response: includes[]=attachments.
Show child attributes
Show child attributes
UUID of the attachment.
Use the following parameter to include vat_details in the response: includes[]=vat_details.
Show child attributes
Show child attributes
One item for each specific VAT line.
Show child attributes
Show child attributes
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).
Show child attributes
Show child attributes
Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Show child attributes
Show child attributes
Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Show child attributes
Show child attributes
Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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).
Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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).
Show child attributes
Show child attributes
Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).
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.
Show child attributes
Show child attributes
Code in the PagoPA Payment Advice that identifies the payment notice, to be used for payments with PagoPA (i.e. codice_avviso).
Code in the PagoPA Payment Notice that identifies the creditor institution, to be used for PagoPA payments (i.e. codice_ent)
Unique Payment Identifier (UPI) is the code that uniquely identifies exclusively a requested payment.
Show child attributes
Show child attributes
Account number of the transaction’s counterparty.
Account number format of the transaction’s counterparty.
Bank identifier of the transaction’s counterparty.
Bank identifier format of the transaction’s counterparty.
Unique mandate reference for the Direct Debit Collection.
Was this page helpful?