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

# List My Orgs

> List every org the authenticated user belongs to, with their role.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v2/external/orgs
openapi: 3.1.0
info:
  title: Lyceum Cloud API
  version: 0.1.0
servers:
  - url: https://api.lyceum.technology
    description: Production
security:
  - bearerAuth: []
paths:
  /api/v2/external/orgs:
    get:
      tags:
        - Organizations
      summary: List My Orgs
      description: List every org the authenticated user belongs to, with their role.
      operationId: list_my_orgs_api_v2_external_orgs_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/OrgWithRole'
                type: array
                title: Response List My Orgs Api V2 External Orgs Get
components:
  schemas:
    OrgWithRole:
      properties:
        slug:
          type: string
          maxLength: 64
          minLength: 1
          pattern: ^[a-z0-9][a-z0-9-]*$
          title: Slug
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
        id:
          type: string
          title: Id
        billing_email:
          anyOf:
            - type: string
            - type: 'null'
          title: Billing Email
        billing_details:
          anyOf:
            - $ref: '#/components/schemas/OrgBillingDetails'
            - type: 'null'
        created_at:
          type: string
          format: date-time
          title: Created At
        role:
          $ref: '#/components/schemas/OrgRole'
      type: object
      required:
        - slug
        - name
        - id
        - created_at
        - role
      title: OrgWithRole
      description: An org along with the current user's role in it.
    OrgBillingDetails:
      properties:
        billing_company_name:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Billing Company Name
        billing_address_line1:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Billing Address Line1
        billing_address_line2:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Billing Address Line2
        billing_city:
          anyOf:
            - type: string
              maxLength: 128
            - type: 'null'
          title: Billing City
        billing_state:
          anyOf:
            - type: string
              maxLength: 128
            - type: 'null'
          title: Billing State
        billing_postal_code:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Billing Postal Code
        billing_country:
          anyOf:
            - type: string
              maxLength: 2
            - type: 'null'
          title: Billing Country
        billing_tax_id:
          anyOf:
            - type: string
              maxLength: 64
            - type: 'null'
          title: Billing Tax Id
        billing_tax_id_type:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Billing Tax Id Type
      type: object
      title: OrgBillingDetails
      description: |-
        An org's company billing details (stored in ``org_billing_details``,
        1:1 with the org). Synced onto the Stripe customer at checkout so they
        render on the generated invoice (Bill to / VAT). All optional — an org
        with none set falls back to Stripe's default (customer email only).
    OrgRole:
      type: string
      enum:
        - owner
        - admin
        - member
      title: OrgRole
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass an API key (prefixed `lk_`) or a JWT access token as a bearer
        token. Generate API keys in the dashboard at
        https://dashboard.lyceum.technology/api-keys.

````