> ## Documentation Index > Fetch the complete documentation index at: https://sure-917046f5-mintlify-docs-update-1787426866557.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List transactions > Returns global ledger history for accessible accounts, including disabled accounts but excluding accounts pending deletion. ## Transaction Type Reference These values describe the economic type of a transaction event. They are **not** accounting classifications; accounting treatment is the selected Chart-of-Accounts account on the linked journal entry. Some values use spaces instead of underscores (e.g., `INTERCOMPANY TRANSFER`, `CLAIM REWARD`). Always reference the exact values below. | Transaction type | Description | | ----------------------- | ------------------------------------------- | | `DEPOSIT` | Inbound receipt of funds | | `WITHDRAWAL` | Outbound transfer of funds | | `SWAP` | Exchange of one asset for another | | `BRIDGE` | Cross-chain transfer | | `INTERCOMPANY TRANSFER` | Transfer between legal entities | | `INTERNAL TRANSFER` | Transfer within the same legal entity | | `FEE` | Network gas, exchange, or service fee | | `MINTING` | Creation of new tokens | | `STAKING_REWARD` | Yield from staking | | `INVOICE` | Payment received against a customer invoice | | `BILL` | Payment against a vendor bill | | `CLAIM REWARD` | Protocol or ecosystem reward claim | | `BORROW` | Borrowing event | | `REPAYMENT` | Loan repayment | | `RESERVES CHANGE` | Treasury reserves adjustment | | `REALIZED_PNL` | Realized profit or loss | | `NFT` | NFT mint, sale, or transfer | | `SPAM` | Spam/airdrop (auto-hides from accounting) | | `UNKNOWN` | Type not yet determined, pending review | ## OpenAPI ````yaml /openapi.yaml get /api/v1/transactions openapi: 3.0.3 info: title: Sure API version: v1 description: OpenAPI documentation generated from executable request specs. servers: - url: https://app.sure.am description: Production - url: http://localhost:3000 description: Local development security: [] paths: /api/v1/transactions: get: tags: - Transactions summary: List transactions description: >- Returns global ledger history for accessible accounts, including disabled accounts but excluding accounts pending deletion. parameters: - name: page in: query required: false description: 'Page number (default: 1)' schema: type: integer - name: per_page in: query required: false description: 'Items per page (default: 25, max: 100)' schema: type: integer - name: account_id in: query required: false description: Filter by account ID schema: type: string - name: category_id in: query required: false description: Filter by category ID schema: type: string - name: merchant_id in: query required: false description: Filter by merchant ID schema: type: string - name: start_date in: query required: false description: Filter transactions from this date schema: type: string format: date - name: end_date in: query required: false description: Filter transactions until this date schema: type: string format: date - name: min_amount in: query required: false description: Filter by minimum amount schema: type: number - name: max_amount in: query required: false description: Filter by maximum amount schema: type: number - name: type in: query required: false description: Filter by transaction type schema: type: string enum: - income - expense - name: search in: query required: false description: Search by name, notes, or merchant name schema: type: string - name: account_ids in: query required: false description: Filter by multiple account IDs schema: type: array items: type: string - name: category_ids in: query required: false description: Filter by multiple category IDs schema: type: array items: type: string - name: merchant_ids in: query required: false description: Filter by multiple merchant IDs schema: type: array items: type: string - name: tag_ids in: query required: false description: Filter by tag IDs schema: type: array items: type: string responses: '200': description: transactions filtered by date range content: application/json: schema: $ref: '#/components/schemas/TransactionCollection' security: - apiKeyAuth: [] components: schemas: TransactionCollection: type: object required: - transactions - pagination properties: transactions: type: array items: $ref: '#/components/schemas/Transaction' pagination: $ref: '#/components/schemas/Pagination' Transaction: type: object required: - id - date - amount - currency - name - classification - account - tags - created_at - updated_at properties: id: type: string format: uuid date: type: string format: date amount: type: string currency: type: string name: type: string notes: type: string nullable: true external_id: type: string nullable: true source: type: string nullable: true classification: type: string account: $ref: '#/components/schemas/Account' category: $ref: '#/components/schemas/Category' nullable: true merchant: $ref: '#/components/schemas/Merchant' nullable: true tags: type: array items: $ref: '#/components/schemas/Tag' transfer: $ref: '#/components/schemas/Transfer' nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time Pagination: type: object required: - page - per_page - total_count - total_pages properties: page: type: integer minimum: 1 per_page: type: integer minimum: 1 total_count: type: integer minimum: 0 total_pages: type: integer minimum: 0 Account: type: object required: - id - name - account_type properties: id: type: string format: uuid name: type: string account_type: type: string nullable: true status: type: string Category: type: object required: - id - name - color - icon properties: id: type: string format: uuid name: type: string color: type: string icon: type: string Merchant: type: object required: - id - name properties: id: type: string format: uuid name: type: string Tag: type: object required: - id - name - color properties: id: type: string format: uuid name: type: string color: type: string Transfer: type: object required: - id - amount - currency properties: id: type: string format: uuid amount: type: string currency: type: string other_account: $ref: '#/components/schemas/Account' nullable: true securitySchemes: apiKeyAuth: type: apiKey name: X-Api-Key in: header description: API key for authentication. Generate one from your account settings. ````