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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List organizations

> Lists organizations the authenticated user belongs to, optionally filtered by name or ID.



## OpenAPI

````yaml https://automate.ax/api/v1/openapi.json get /organizations
openapi: 3.1.1
info:
  title: Automate.ax API
  version: 0.0.0
servers:
  - url: https://automate.ax/api/v1
security:
  - bearerAuth: []
paths:
  /organizations:
    get:
      tags:
        - Organizations
      summary: List organizations
      description: >-
        Lists organizations the authenticated user belongs to, optionally
        filtered by name or ID.
      operationId: listOrganizations
      parameters:
        - name: query
          in: query
          schema:
            type: string
            minLength: 1
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OrganizationSummary'
components:
  schemas:
    OrganizationSummary:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        logo:
          anyOf:
            - type: string
            - type: 'null'
        metadata:
          anyOf:
            - type: string
            - type: 'null'
        createdAt:
          type: string
          format: date-time
          x-native-type: date
        role:
          $ref: '#/components/schemas/OrganizationRole'
        memberCount:
          type: number
        pendingInvitationCount:
          type: number
        projectCount:
          type: number
        activeSubscription:
          anyOf:
            - $ref: '#/components/schemas/ActiveSubscription'
            - type: 'null'
        plan:
          enum:
            - free
            - pro
            - enterprise
          type: string
        limits:
          type: object
          properties:
            aiSpendUsd:
              type: number
            emailRecipients:
              type: number
            projects:
              type: number
            seats:
              type: number
          required:
            - aiSpendUsd
            - emailRecipients
            - projects
            - seats
        usage:
          type: object
          properties:
            aiSpendUsd:
              type: number
            emailRecipients:
              type: number
          required:
            - aiSpendUsd
            - emailRecipients
      required:
        - id
        - name
        - logo
        - metadata
        - createdAt
        - role
        - memberCount
        - pendingInvitationCount
        - projectCount
        - activeSubscription
        - plan
        - limits
        - usage
    OrganizationRole:
      enum:
        - member
        - admin
        - owner
      type: string
    ActiveSubscription:
      type: object
      properties:
        id:
          type: string
        plan:
          type: string
        status:
          type: string
        periodEnd:
          anyOf:
            - type: string
              format: date-time
              x-native-type: date
            - type: 'null'
        cancelAtPeriodEnd:
          type: boolean
      required:
        - id
        - plan
        - status
        - periodEnd
        - cancelAtPeriodEnd
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Automate.ax user session bearer token.

````