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

# Void Journal API

> Void a posted manual journal in Breezing to take it and its reversal out of the books while keeping it listed for the audit trail.



## OpenAPI

````yaml POST /journals/{id}/void
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:
  /journals/{id}/void:
    post:
      tags:
        - Journals
      summary: Void a posted journal
      description: >-
        Take a POSTED manual journal out of the books, together with its
        reversal when it carries a reversal date. It stays listed with status
        "voided" and its lines stop counting in every report from the next read.
        A journal that was published to Xero or QuickBooks from the dashboard is
        removed there first; when the provider refuses, the void answers 400 and
        the journal stays posted. 409 when the journal is not posted, when its
        date is on or before the Books Lock Date, or when it changed while it
        was being voided (read it again, then void). Irreversible: create a new
        journal to book the entry again.
      parameters:
        - schema:
            type: string
            description: Journal ID
            example: '12'
          required: true
          description: Journal ID
          name: id
          in: path
        - 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
      responses:
        '200':
          description: The journal
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/JournalSummary'
                required:
                  - success
                  - data
        '400':
          description: Invalid journal, or the posting rules are not met
          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
        '404':
          description: Journal not found
          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
        '409':
          description: >-
            Not posted, dated in the locked period, or changed while it was
            being voided
          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:
    JournalSummary:
      type: object
      properties:
        id:
          type: number
        kind:
          type: string
          enum:
            - manual
            - opening
          description: >-
            "manual" = a manual journal; "opening" = the take-on journal that
            carries opening balances (read only through this API).
        status:
          type: string
          description: >-
            draft | posted | voided (and replaced for superseded versions). ONLY
            posted journals are in the books.
        number:
          type: number
          nullable: true
        numberLabel:
          type: string
          nullable: true
          example: MJ-0007
        date:
          type: string
          nullable: true
          description: The journal day, yyyy-MM-dd (UTC).
          example: '2026-03-31'
        reversalDate:
          type: string
          nullable: true
          description: >-
            The day the journal reverses itself, yyyy-MM-dd (UTC), null when it
            never does. A posted journal with a reversal date is in the books
            twice: on its date and, with debits and credits swapped, on this
            day.
          example: '2026-04-01'
        amountsAre:
          type: string
          enum:
            - noTax
            - exclusive
            - inclusive
          description: >-
            "noTax" = no VAT is calculated (a tax rate only files its line on
            the VAT report); "exclusive" = the VAT of every taxed line is booked
            on top of its amount; "inclusive" = the VAT is carved out of its
            amount.
        reference:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
          description: The narration; the fallback description of every line.
        lineCount:
          type: integer
        totalDebit:
          type: string
          description: What the journal books on the debit side, calculated VAT included.
        totalCredit:
          type: string
          description: What the journal books on the credit side, calculated VAT included.
        balanced:
          type: boolean
        attachmentCount:
          type: integer
          description: >-
            How many supporting files are attached to the journal (GET
            /journals/{id}/attachments lists them).
        replacesId:
          type: number
          nullable: true
          description: >-
            The posted version this one superseded, when the journal was edited
            after posting.
        postedAt:
          type: number
          nullable: true
          description: unix ms
        voidedAt:
          type: number
          nullable: true
          description: unix ms
        xeroPublishState:
          type: string
          enum:
            - none
            - published
            - outdated
          description: >-
            The copy at the provider (Xero or QuickBooks), published from the
            dashboard: none = never published; published = up to date; outdated
            = the journal changed since (an edit returns a new version), publish
            again from the dashboard.
        qboPublishState:
          type: string
          enum:
            - none
            - published
            - outdated
          description: >-
            The copy at the provider (Xero or QuickBooks), published from the
            dashboard: none = never published; published = up to date; outdated
            = the journal changed since (an edit returns a new version), publish
            again from the dashboard.
        createdAt:
          type: number
          description: unix ms
        updatedAt:
          type: number
          description: unix ms
      required:
        - id
        - kind
        - status
        - number
        - numberLabel
        - date
        - reversalDate
        - amountsAre
        - reference
        - description
        - lineCount
        - totalDebit
        - totalCredit
        - balanced
        - attachmentCount
        - replacesId
        - postedAt
        - voidedAt
        - xeroPublishState
        - qboPublishState
        - createdAt
        - updatedAt

````

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