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

# Renvoie les horaires d'un établissement



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/v1/establishments/{establishment_slug}/hours
openapi: 3.0.1
info:
  title: Le Commis API
  version: v1
  description: >-
    API permettant aux sites externes de lire les informations à jour d'un
    établissement.
servers:
  - url: https://app.lecommis.fr
    description: Production
security: []
paths:
  /api/v1/establishments/{establishment_slug}/hours:
    get:
      tags:
        - Horaires
      summary: Renvoie les horaires d'un établissement
      parameters:
        - name: establishment_slug
          in: path
          required: true
          schema:
            type: string
          description: Slug de l'établissement
      responses:
        '200':
          description: Horaires de l'établissement
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Hours'
        '401':
          description: Clé API invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Établissement introuvable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Quota de requêtes dépassé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - api_key: []
components:
  schemas:
    Hours:
      type: object
      additionalProperties: false
      required:
        - content_revision
        - business_hours
        - special_hours_coming
      properties:
        content_revision:
          type: integer
          format: int64
          example: 67
          description: Révision monotone du contenu public de l'établissement.
        business_hours_summary:
          type: string
          nullable: true
          example: Ouvert du mardi au dimanche, 12h–14h et 19h–22h
        business_hours:
          type: array
          items:
            $ref: '#/components/schemas/BusinessHoursPeriod'
        special_hours_coming:
          type: array
          items:
            $ref: '#/components/schemas/SpecialHoursPeriod'
    ApiError:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
        details:
          type: array
          items:
            type: string
    BusinessHoursPeriod:
      type: object
      additionalProperties: false
      required:
        - open_day
        - open_time
        - close_day
        - close_time
      properties:
        open_day:
          type: string
          example: Lundi
        open_time:
          type: string
          nullable: true
          example: '12:00'
        close_day:
          type: string
          nullable: true
          example: Lundi
        close_time:
          type: string
          nullable: true
          example: '14:00'
    SpecialHoursPeriod:
      type: object
      additionalProperties: false
      required:
        - start_date
        - end_date
        - open_time
        - close_time
        - closed
      properties:
        start_date:
          type: string
          format: date
          example: '2026-12-24'
        end_date:
          type: string
          format: date
          nullable: true
          example: '2026-12-26'
        open_time:
          type: string
          nullable: true
          example: '12:00'
        close_time:
          type: string
          nullable: true
          example: '14:00'
        closed:
          type: boolean
          example: true
  securitySchemes:
    api_key:
      type: apiKey
      name: X-Api-Key
      in: header
      description: Clé API de l'établissement. Elle doit rester côté serveur.

````