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

# List Organizations

> List every organization (id + name) for the cross-org switcher, name-ordered.

Prod has ~194 orgs against a 50-per-page limit, so a flat first page silently truncates; `q`
lets the switcher narrow to the org the operator is typing rather than paging through all of them.
Absent/whitespace-only `q` returns the unfiltered first page.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/organizations
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/organizations:
    get:
      tags:
        - Organization
      summary: List Organizations
      description: >-
        List every organization (id + name) for the cross-org switcher,
        name-ordered.


        Prod has ~194 orgs against a 50-per-page limit, so a flat first page
        silently truncates; `q`

        lets the switcher narrow to the org the operator is typing rather than
        paging through all of them.

        Absent/whitespace-only `q` returns the unfiltered first page.
      operationId: integrations_api_api_v2_organizations_router_list_organizations
      parameters:
        - in: query
          name: q
          schema:
            description: Case-insensitive name substring filter, applied before pagination
            title: Q
            type: string
          required: false
          description: Case-insensitive name substring filter, applied before pagination
        - in: query
          name: page
          schema:
            default: 1
            minimum: 1
            title: Page
            type: integer
          required: false
        - in: query
          name: page_size
          schema:
            anyOf:
              - minimum: 1
                type: integer
              - type: 'null'
            title: Page Size
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedOrganizationListItemOutput'
      security:
        - OAuth2: []
components:
  schemas:
    PagedOrganizationListItemOutput:
      properties:
        items:
          items:
            $ref: '#/components/schemas/OrganizationListItemOutput'
          title: Items
          type: array
        count:
          title: Count
          type: integer
      required:
        - items
        - count
      title: PagedOrganizationListItemOutput
      type: object
    OrganizationListItemOutput:
      description: Minimal org identity for the superuser switcher list — id and name only.
      properties:
        id:
          format: uuid
          title: Id
          type: string
        name:
          title: Name
          type: string
      required:
        - id
        - name
      title: OrganizationListItemOutput
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````