Transactions and statements - Qonto

Read your transactions and monthly statements, attach receipts to transactions, and sort transactions into cash flow categories.

Transactions

Command	What it does	OAuth scope
`qonto transactions attachments list <id>`	List attachments for a transaction	`organization.read`
`qonto transactions attachments remove <transaction-id> <attachment-id>`	Remove an attachment from a transaction	`attachment.write`
`qonto transactions attachments remove-all <id>`	Remove all attachments from a transaction	`attachment.write`
`qonto transactions attachments upload <id>`	Upload an attachment to a transaction	`attachment.write`
`qonto transactions child-links <id>`	List child transaction links	`organization.read`
`qonto transactions get <id>`	Retrieve a transaction	`organization.read`
`qonto transactions list`	List transactions	`organization.read`

qonto transactions list works on one business account at a time. Pass --bank-account-id or --iban; without either, the CLI uses your main account and says so on standard error. Add --includes labels,attachments,vat_details to embed those in each transaction.

Attachments

Command	What it does	OAuth scope
`qonto attachments get <id>`	Retrieve an attachment	`organization.read`
`qonto attachments upload`	Upload an attachment	`attachment.write`

To attach a receipt to a transaction in one step, use qonto transactions attachments upload <transaction-id> --file <path>. qonto attachments upload stores a file on its own and returns its id, which other requests (such as supplier invoices or transfer requests) can then reference.

Statements

Command	What it does	OAuth scope
`qonto statements get <id>`	Retrieve a statement	`organization.read`
`qonto statements list`	List statements	`organization.read`

Cash flow categories

Command	What it does	OAuth scope
`qonto cash-flow-categories assign`	Assign a cash flow category to transactions	`cash_flow_category.write`
`qonto cash-flow-categories create`	Create a cash flow category	`cash_flow_category.write`
`qonto cash-flow-categories create-subcategory <category-id>`	Create a cash flow subcategory	`cash_flow_category.write`
`qonto cash-flow-categories list`	List cash flow categories	`cash_flow_category.read`
`qonto cash-flow-categories unassign`	Unassign a cash flow category from transactions	`cash_flow_category.write`

Try it

# Card spending since the start of the month
qonto transactions list --side debit --operation-type card \
  --settled-at-from 2026-09-01 --all --fields settled_at,amount,label

# Completed transactions that still have no receipt
qonto transactions list --status completed --with-attachments=false --all \
  --fields id,settled_at,amount,label

# Attach a receipt
qonto transactions attachments upload <transaction-id> --file receipt.pdf

# Statements for the first half of the year
qonto statements list --period-from 01-2026 --period-to 06-2026

# Tag transactions with a cash flow category
qonto cash-flow-categories assign --category-id <category-id> \
  --transaction-ids <transaction-id>,<transaction-id>