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

# List rooms

> One page of your organization's rooms, newest first.

Covers every room in the organization, including ones started by teammates —
`created_by` names whoever started each room. Minutes and charges are final once
a room has ended; a room still in progress reports what has been metered so far.

Use `limit` and `offset` to page through the list.



## OpenAPI

````yaml https://api.staging.glot.com/openapi.json get /v1/rooms
openapi: 3.1.0
info:
  title: glot-api
  version: 0.1.0
servers: []
security: []
tags:
  - name: rooms
    description: Create translation rooms and let participants join them.
  - name: usage
    description: Minutes and charges over time, for reporting and charts.
  - name: billing
    description: Buy prepaid credit and review the balance behind it.
  - name: api-keys
    description: Create and revoke keys used to authenticate requests.
  - name: supported-languages
    description: Languages available for translation.
  - name: users
    description: The authenticated user's own profile.
paths:
  /v1/rooms:
    get:
      tags:
        - rooms
      summary: List rooms
      description: >-
        One page of your organization's rooms, newest first.


        Covers every room in the organization, including ones started by
        teammates —

        `created_by` names whoever started each room. Minutes and charges are
        final once

        a room has ended; a room still in progress reports what has been metered
        so far.


        Use `limit` and `offset` to page through the list.
      operationId: list_rooms_v1_rooms_get
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 50
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageResponse_RoomResponse_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    PageResponse_RoomResponse_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/RoomResponse'
          type: array
          title: Items
        limit:
          type: integer
          title: Limit
        offset:
          type: integer
          title: Offset
        next_offset:
          anyOf:
            - type: integer
            - type: 'null'
          title: Next Offset
      type: object
      required:
        - items
        - limit
        - offset
        - next_offset
      title: PageResponse[RoomResponse]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RoomResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        sid:
          anyOf:
            - type: string
            - type: 'null'
          title: Sid
        status:
          type: string
          title: Status
        streaming_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Streaming Mode
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        ended_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Ended At
        total_connection_minutes:
          type: integer
          title: Total Connection Minutes
        total_charged_cents:
          type: integer
          title: Total Charged Cents
        created_at:
          type: string
          format: date-time
          title: Created At
        created_by:
          type: string
          title: Created By
      type: object
      required:
        - id
        - name
        - sid
        - status
        - streaming_mode
        - started_at
        - ended_at
        - total_connection_minutes
        - total_charged_cents
        - created_at
        - created_by
      title: RoomResponse
      description: >-
        A room and its metered usage.


        `total_connection_minutes` sums every participant's connected minutes,
        so a

        10-minute call with three people is 30 minutes. `total_charged_cents` is
        what that

        cost, each participant priced at the rate for its own class. Both are
        final once

        `ended_at` is set. Join tokens are never returned here.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````