> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qonto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions and statements

> Transactions, attachments, statements, and cash flow categories

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](/api-reference/business-api/expense-management/attachments-in-transactions/list-attachments-for-a-transaction)               | `organization.read` |
| `qonto transactions attachments remove <transaction-id> <attachment-id>` | [Remove an attachment from a transaction](/api-reference/business-api/expense-management/attachments-in-transactions/remove-an-attachment-from-a-transaction)     | `attachment.write`  |
| `qonto transactions attachments remove-all <id>`                         | [Remove all attachments from a transaction](/api-reference/business-api/expense-management/attachments-in-transactions/remove-all-attachments-from-a-transaction) | `attachment.write`  |
| `qonto transactions attachments upload <id>`                             | [Upload an attachment to a transaction](/api-reference/business-api/expense-management/attachments-in-transactions/upload-an-attachment-to-a-transaction)         | `attachment.write`  |
| `qonto transactions child-links <id>`                                    | [List child transaction links](/api-reference/business-api/transactions-statements/transactions/list-child-transaction-links)                                     | `organization.read` |
| `qonto transactions get <id>`                                            | [Retrieve a transaction](/api-reference/business-api/transactions-statements/transactions/retrieve-a-transaction)                                                 | `organization.read` |
| `qonto transactions list`                                                | [List transactions](/api-reference/business-api/transactions-statements/transactions/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](/api-reference/business-api/expense-management/attachments/retrieve-an-attachment) | `organization.read` |
| `qonto attachments upload`   | [Upload an attachment](/api-reference/business-api/expense-management/attachments/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](/api-reference/business-api/transactions-statements/statements/retrieve-a-statement) | `organization.read` |
| `qonto statements list`     | [List statements](/api-reference/business-api/transactions-statements/statements/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](/api-reference/business-api/transactions-statements/cash-flow-categories/assign)       | `cash_flow_category.write` |
| `qonto cash-flow-categories create`                           | [Create a cash flow category](/api-reference/business-api/transactions-statements/cash-flow-categories/create)                       | `cash_flow_category.write` |
| `qonto cash-flow-categories create-subcategory <category-id>` | [Create a cash flow subcategory](/api-reference/business-api/transactions-statements/cash-flow-categories/create-subcategory)        | `cash_flow_category.write` |
| `qonto cash-flow-categories list`                             | [List cash flow categories](/api-reference/business-api/transactions-statements/cash-flow-categories/list)                           | `cash_flow_category.read`  |
| `qonto cash-flow-categories unassign`                         | [Unassign a cash flow category from transactions](/api-reference/business-api/transactions-statements/cash-flow-categories/unassign) | `cash_flow_category.write` |

**Try it**

```bash theme={null}
# 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>
```