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

# List VAT Report Transactions API

> List the Breezing transactions behind a VAT report period, filtered by sales or purchases side and tax rate, to trace each total.



## OpenAPI

````yaml GET /vat-report/transactions
openapi: 3.1.0
info:
  title: Breezing Public API
  version: 1.0.0
  description: >-
    Crypto accounting API for programmatic access and AI agents. Authenticate
    with an API key using the Authorization header: `Bearer brz_...`
servers:
  - url: https://api.breezing.io/v1
security:
  - BearerAuth: []
paths:
  /vat-report/transactions:
    get:
      tags:
        - VAT Report
      summary: List the transactions behind the VAT report
      description: >-
        The VAT report covers a period of two inclusive UTC days on an ACCRUAL
        basis (transaction date, invoice impact date, journal date) in the
        company currency. It reads plain in/out transactions naming a tax rate
        (trade legs, internal transfers and spam never count), approved received
        invoices that are in the books (the scanned VAT amount, credit notes
        negative) and posted manual journal lines carrying a tax rate. Amounts
        are signed so the normal direction of each side is positive. Rows naming
        a rate that cannot split (not in the tax rate catalog, or no VAT GL
        account on that side) are listed apart under `notSplit` with their
        gross, never guessed into the totals. Issued invoices are NOT in the
        books, so they are returned for information only and never summed.


        Lists the transactions of the period that name a tax rate, oldest first,
        each with its own net, VAT and gross. Narrow by `side` and by `rate` (a
        rateKey from GET /vat-report, or the rate name). Use GET
        /transactions/{id} for the full row.
      parameters:
        - schema:
            type: string
            description: >-
              Organization ID. Use GET /v1/companies to discover available
              org/company pairs.
            example: '1'
          required: true
          description: >-
            Organization ID. Use GET /v1/companies to discover available
            org/company pairs.
          name: orgId
          in: query
        - schema:
            type: string
            description: >-
              Company ID. Use GET /v1/companies to discover available companies
              and their access levels.
            example: '1'
          required: true
          description: >-
            Company ID. Use GET /v1/companies to discover available companies
            and their access levels.
          name: companyId
          in: query
        - schema:
            type: string
            description: First day of the period, yyyy-MM-dd (UTC), inclusive.
            example: '2026-01-01'
          required: true
          description: First day of the period, yyyy-MM-dd (UTC), inclusive.
          name: dateFrom
          in: query
        - schema:
            type: string
            description: Last day of the period, yyyy-MM-dd (UTC), inclusive.
            example: '2026-03-31'
          required: true
          description: Last day of the period, yyyy-MM-dd (UTC), inclusive.
          name: dateTo
          in: query
        - schema:
            type: string
            enum:
              - sales
              - purchases
          required: false
          name: side
          in: query
        - schema:
            type: string
            maxLength: 200
            description: Tax rate name, matched trimmed and case-insensitively.
          required: false
          description: Tax rate name, matched trimmed and case-insensitively.
          name: rate
          in: query
        - schema:
            type: string
            default: '50'
            description: Rows per page (1-200, default 50).
          required: false
          description: Rows per page (1-200, default 50).
          name: limit
          in: query
        - schema:
            type: string
            default: '0'
            description: Rows to skip (default 0).
          required: false
          description: Rows to skip (default 0).
          name: offset
          in: query
      responses:
        '200':
          description: Transactions
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/VatReportTransaction'
                  pagination:
                    type: object
                    properties:
                      limit:
                        type: integer
                      offset:
                        type: integer
                      total:
                        type: integer
                      hasMore:
                        type: boolean
                    required:
                      - limit
                      - offset
                      - total
                      - hasMore
                required:
                  - success
                  - data
                  - pagination
        '400':
          description: Invalid period
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '403':
          description: >-
            API key has no access to this company, has read-only access where
            write was required, or the company subscription is inactive
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
      security:
        - BearerAuth: []
components:
  schemas:
    VatReportTransaction:
      type: object
      properties:
        id:
          type: number
        date:
          type: number
          nullable: true
          description: unix ms
        transactionId:
          type: string
          nullable: true
          description: The transaction hash or venue reference.
        direction:
          type: string
          nullable: true
        side:
          type: string
          enum:
            - sales
            - purchases
        token:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        account:
          type: string
        vat:
          type: string
        rateName:
          type: string
        type:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        walletId:
          type: number
          nullable: true
        walletName:
          type: string
          nullable: true
        counterparty:
          type: string
        isLocked:
          type: boolean
          nullable: true
        net:
          type: string
        vatAmount:
          type: string
        gross:
          type: string
        notSplit:
          type: string
          nullable: true
          enum:
            - unknownRate
            - unmappedSide
            - noVatAmount
            - null
          description: >-
            unknownRate = the rate is not in the tax rate catalog; unmappedSide
            = the rate has no VAT GL account on this side; noVatAmount = a
            received invoice without a usable scanned VAT amount.
      required:
        - id
        - date
        - transactionId
        - direction
        - side
        - token
        - amount
        - account
        - vat
        - rateName
        - type
        - note
        - walletId
        - walletName
        - counterparty
        - isLocked
        - net
        - vatAmount
        - gross
        - notSplit

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.