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

# Get all the halls

> Retrieves a list of all halls available in the system.
This is a public endpoint and does not require authentication. The returned list can be empty if no halls have been created yet.




## OpenAPI

````yaml api-reference/openapi.json get /api/halls
openapi: 3.0.0
info:
  title: Tandem IT API
  version: 1.0.0
  description: API for tandem it backend
servers:
  - url: https://tandem.hlofiys.xyz
    description: Production server
security: []
tags:
  - name: Documentation
    description: API documentation endpoint
paths:
  /api/halls:
    get:
      tags:
        - Halls
      summary: Get all the halls
      description: >
        Retrieves a list of all halls available in the system.

        This is a public endpoint and does not require authentication. The
        returned list can be empty if no halls have been created yet.
      operationId: getAllHalls
      responses:
        '200':
          description: Successful response. Returns an array of all existing halls
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Hall'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Hall:
      type: object
      required:
        - hall_id
        - name
        - address
        - seating_chart_image_url
      properties:
        hall_id:
          type: integer
          format: int64
          description: Unique hall ID
        name:
          type: string
          description: Hall name
        address:
          type: string
          description: Hall address
        seating_chart_image_url:
          type: string
          description: Link to download the hall seating chart
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string

````