> ## 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.

# Get a room

> One room, with a per-participant breakdown of its usage.

Shows when each participant joined and left, and the minutes and charge that came
from their connection. Returns 404 if the room does not belong to your
organization.



## OpenAPI

````yaml https://api.staging.glot.com/openapi.json get /v1/rooms/{room_id}
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/{room_id}:
    get:
      tags:
        - rooms
      summary: Get a room
      description: >-
        One room, with a per-participant breakdown of its usage.


        Shows when each participant joined and left, and the minutes and charge
        that came

        from their connection. Returns 404 if the room does not belong to your

        organization.
      operationId: get_room_v1_rooms__room_id__get
      parameters:
        - name: room_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Room Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoomDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    RoomDetailResponse:
      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
        participants:
          items:
            $ref: '#/components/schemas/ParticipantUsageResponse'
          type: array
          title: Participants
      type: object
      required:
        - id
        - name
        - sid
        - status
        - streaming_mode
        - started_at
        - ended_at
        - total_connection_minutes
        - total_charged_cents
        - created_at
        - created_by
        - participants
      title: RoomDetailResponse
      description: A room with its usage broken down per participant.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ParticipantUsageResponse:
      properties:
        participant_identity:
          type: string
          title: Participant Identity
        participant_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Participant Kind
        languages:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Languages
        joined_at:
          type: string
          format: date-time
          title: Joined At
        left_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Left At
        connection_minutes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Connection Minutes
        charged_cents:
          anyOf:
            - type: integer
            - type: 'null'
          title: Charged Cents
      type: object
      required:
        - participant_identity
        - participant_kind
        - languages
        - joined_at
        - left_at
        - connection_minutes
        - charged_cents
      title: ParticipantUsageResponse
      description: >-
        One participant's connection to a room, and what it cost.


        A participant who drops and rejoins appears once per connection.

        `connection_minutes` and `charged_cents` are `null` while the
        participant is still

        connected.
    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

````