List transactions

Authorizations

Authorization

string

header

required

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

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

bank_account_id

string

id of the bank account for which transactions will be retrieved. Use /v2/organization to get this parameter. If both bank_account_id and iban are specified, bank_account_id takes precedence.

Example:

"018f71db-c635-78b5-b90a-ea05de98c2bf"

iban

string

IBAN of the bank account for which transactions will be retrieved. Use /v2/organization to get this parameter. If both bank_account_id and iban are specified, bank_account_id takes precedence.

Example:

"FR7616798000010000005663951"

includes[]

enum<string>[]

Use this query parameter to embed the associated resources (labels, attachments and/or VAT details) of the transactions in the JSON response.

Available options:

vat_details,

labels,

attachments

status[]

enum<string>[]

Transactions can be filtered by their status property. Possible values:

pending: a transaction that is processing and has impacted the bank account's auth_balance but not its balance;
declined: a transaction that has been declined;
completed: a transaction that is completed, and has impacted the bank account's balance.

Available options:

pending,

declined,

completed

updated_at_from

string

Transactions can be filtered by their updated_at property. This filter can be used in combination with the updated_at_to query parameter to get transactions updated within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

updated_at_to

string

Example:

"2019-01-10T11:47:53.123Z"

created_at_from

string

Transactions can be filtered by their created_at property. Can be use in combination with the created_at_to query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

created_at_to

string

Transactions can be filtered by their created_at property. This filter can be used in combination with the created_at_from query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

emitted_at_from

string

Transactions can be filtered by their emitted_at property. Can be use in combination with the emitted_at_to query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

emitted_at_to

string

Transactions can be filtered by their emitted_at property. This filter can be used in combination with the emitted_at_from query parameter to get transactions emitted within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

settled_at_from

string

Transactions can be filtered by their settled_at property. This filter can be used in combination with the settled_at_to query parameter to get transactions settled within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

settled_at_to

string

Transactions can be filtered by their settled_at property. This filter can be used in combination with the settled_at_from query parameter to get transactions settled within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

side

enum<string>

Transactions can be filtered by their side property.

Available options:

credit,

debit

operation_type[]

string[]

Transactions can be filtered by their operation_type property.

Example:

"operation_type[]=card&operation_type[]=transfer&operation_type[]=income&operation_type[]=account_remuneration"

with_attachments

enum<boolean>

Transactions can be filtered based on the presence of one or more attachments.

Available options:

true,

false

sort_by

string<property:order>

default:`settled_at:desc`

Transactions can be sorted by a specific property and order. Property: created_at, updated_at, settled_at or emitted_at Order: asc (Ascending) / desc (Descending)

page

string

Returned page (cf. Pagination).

per_page

string

Number of transactions per page (cf. Pagination).

Response

Returns the list of transactions for the specified bank account.

transactions

object[]

Show child attributes

transactions.id

string

UUID of the transaction.

transactions.transaction_id

string

transactions.amount

number<float>

Amount of the transaction in the currency of the bank account.

Example:

"10,00"

transactions.amount_cents

integer

Amount of the transaction in the currency of the bank account.

Example:

1000

transactions.settled_balance

number | null

The account balance at the moment the transaction was settled. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.settled_balance_cents

integer | null

default:0

The account balance at the moment the transaction was settled. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.attachment_ids

(string | null)[]

Array of UUIDs, corresponding to the attachments (up to 5) uploaded on the transaction. You can obtain details for each attachment using Get attachment.

transactions.logo

object

Object containing URLs to small and medium-sized logos associated with the transaction.

Show child attributes

transactions.logo.small

string

transactions.logo.medium

string

transactions.local_amount

number<float>

Amount of the transaction in the foreign currency (if any).

Example:

"10,87"

transactions.local_amount_cents

integer

Amount of the transaction in the foreign currency (if any).

Example:

1087

transactions.side

string

credit: incoming transaction
debit: outgoing transaction

transactions.operation_type

string

Available options:

income: an incoming transfer
transfer: an outgoing transfer
card: a card payment
card_acquirer_payout: a daily payout transaction from Tap to Pay card payments
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
account_remuneration : earnings paid by Qonto based on your account balance and transaction history
f24: a tax payment transaction to Italian government agencies using the F24 form
pagopa_payment: a payment transaction to Italian public institutions or utility companies via PagoPA
nrc_payment: a tax payment transaction to Spanish tax authorities (AEAT) with NRC reference
riba_payment: a payment transaction from a supplier's payment request (Italian market)
other: an external transaction for which the type of transaction is unknown

transactions.currency

string

euros is the only bank account currency supported by Qonto.

transactions.local_currency

string

Example:

"USD"

transactions.label

string

Name of the counterparty of the transaction.

transactions.clean_counterparty_name

string

Simplified and standardized version of the counterparty's name.

transactions.settled_at

string | null

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).

transactions.emitted_at

string

Date and time, in UTC, at which the transaction was first authorized and recorded on the bank account.

transactions.created_at

string

Date and time, in UTC, at which the transaction was created.

transactions.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).

transactions.status

string

transactions.note

string | null

transactions.reference

string | null

transactions.vat_amount

number<float> | null

Amount aggregate for all the VAT.

transactions.vat_amount_cents

integer | null

Amount aggregate for all the VAT.

transactions.vat_rate

number<float> | null

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.

Example:

10

transactions.initiator_id

string | null

transactions.label_ids

(string | null)[]

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.

transactions.attachment_lost

boolean

Sets to true if the attachment of the transaction was marked as lost.

transactions.attachment_required

boolean

Sets to true if the attachment of the transaction was marked as required.

transactions.card_last_digits

string | null

transactions.category

string

deprecated

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

transactions.cashflow_category

object

Object containing the cash flow category object

Show child attributes

transactions.cashflow_category.name

string

transactions.cashflow_subcategory

object

Object containing the cash flow subcategory object

Show child attributes

transactions.cashflow_subcategory.name

string

transactions.subject_type

string

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 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
AccountRemuneration: earnings paid by Qonto based on your account balance and transaction history
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. For subject type account_remuneration you will not find any extra nested objects.

transactions.bank_account_id

string

transactions.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).

transactions.attachments

object[] | null

Use the following parameter to include attachments in the response: includes[]=attachments.

Show child attributes

transactions.attachments.id

string

UUID of the attachment.

transactions.attachments.created_at

string

transactions.attachments.file_name

string

transactions.attachments.file_size

string

transactions.attachments.file_content_type

string

transactions.attachments.url

string

transactions.attachments.probative_attachment

object

Show child attributes

transactions.attachments.probative_attachment.status

string

transactions.labels

object[]

Use the following parameter to include labels in the response: includes[]=labels.

Show child attributes

transactions.labels.id

string

UUID of the label.

transactions.labels.name

string

transactions.labels.parent_id

string

transactions.vat_details

object

Use the following parameter to include vat_details in the response: includes[]=vat_details.

Show child attributes

transactions.vat_details.items

object[]

One item for each specific VAT line.

Show child attributes

transactions.vat_details.items.amount

string

transactions.vat_details.items.amount_cents

string

transactions.vat_details.items.amount_excluding_vat

string

transactions.vat_details.items.amount_excluding_vat_cents

string

transactions.vat_details.items.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).

transactions.transfer

object

Show child attributes

transactions.transfer.counterparty_account_number

string

Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.transfer.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.

transactions.transfer.counterparty_bank_identifier

string

Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.transfer.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.

transactions.income

object

Show child attributes

transactions.income.counterparty_account_number

string

Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.income.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.

transactions.income.counterparty_bank_identifier

string

Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.income.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.

transactions.swift_income

object

Show child attributes

transactions.swift_income.counterparty_account_number

string

Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.swift_income.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).

transactions.swift_income.counterparty_bank_identifier

string

Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.swift_income.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).

transactions.direct_debit

object

Show child attributes

transactions.direct_debit.counterparty_account_number

string

Account number of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.direct_debit.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.

transactions.direct_debit.counterparty_bank_identifier

string

Bank identifier of the transaction’s counterparty. Might be empty for external transaction (i.e. when is_external_transaction == true).

transactions.direct_debit.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.

transactions.check

object

Show child attributes

transactions.check.check_number

string

transactions.check.check_key

string

transactions.financing_installment

object

Show child attributes

transactions.financing_installment.total_installments_number

integer

Installment of the current transaction.

transactions.financing_installment.current_installment_number

integer

Total number of installments.

transactions.pagopa_payment

object

Show child attributes

transactions.pagopa_payment.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).

transactions.pagopa_payment.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)

transactions.pagopa_payment.iuv

string

Unique Payment Identifier (UPI) is the code that uniquely identifies exclusively a requested payment.

transactions.direct_debit_collection

object

Show child attributes

transactions.direct_debit_collection.counterparty_account_number

string

Account number of the transaction’s counterparty.

transactions.direct_debit_collection.counterparty_account_number_format

string

Account number format of the transaction’s counterparty.

transactions.direct_debit_collection.counterparty_bank_identifier

string

Bank identifier of the transaction’s counterparty.

transactions.direct_debit_collection.counterparty_bank_identifier_format

string

Bank identifier format of the transaction’s counterparty.

transactions.direct_debit_collection.unique_mandate_reference

string

Unique mandate reference for the Direct Debit Collection.

transactions.direct_debit_hold

object

Show child attributes

transactions.direct_debit_hold.guarding_rate

string

Business API

Onboarding API

List transactions

Authorizations

Headers

Query Parameters

Response