> ## 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 Companies API

> List Breezing companies your API key can access with org IDs, currencies, and read or write access levels for crypto accounting workflows.



## OpenAPI

````yaml GET /companies
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:
  /companies:
    get:
      tags:
        - Companies
      summary: List companies the API key can access
      description: >-
        Returns all companies this API key has access to, with the access level
        granted on each company ("read" or "write"). Call this first when
        integrating to discover the companyId values to pass to other endpoints.
      responses:
        '200':
          description: Companies retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompanySummary'
                required:
                  - success
                  - data
        '400':
          description: Invalid request
          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:
    CompanySummary:
      type: object
      properties:
        id:
          type: number
          description: Company ID
        name:
          type: string
          description: Company name
        orgId:
          type: number
          description: Organization ID
        currency:
          type: string
          description: Base fiat currency (3 chars)
          example: USD
        accessLevel:
          type: string
          enum:
            - read
            - write
          description: >-
            Access level this API key has on the company. "read" allows GET
            endpoints; "write" allows GET + PATCH.
      required:
        - id
        - name
        - orgId
        - currency
        - accessLevel

````