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

# Horarios disponibles

> Slots libres para un profesional en una fecha, descontando agenda, almuerzo y turnos existentes.



## OpenAPI

````yaml /api-reference/openapi.json get /doctors/{id}/available-slots
openapi: 3.1.0
info:
  title: OCLÜ API Pública
  description: >-
    API para integrar OCLÜ con sistemas externos (n8n, Make, Zapier, CRMs).
    Autenticación por API key. Las fechas y horas son hora local de la clínica.
    La API nunca expone datos clínicos.
  version: 1.0.0
servers:
  - url: https://{tenant}.oclucrm.com/api/v1
    description: Reemplazá {tenant} por el subdominio de tu clínica
    variables:
      tenant:
        default: tu-clinica
security:
  - apiKey: []
paths:
  /doctors/{id}/available-slots:
    get:
      tags:
        - Disponibilidad
      summary: Horarios disponibles
      description: >-
        Slots libres para un profesional en una fecha, descontando agenda,
        almuerzo y turnos existentes.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
        - name: date
          in: query
          required: true
          description: Fecha DD-MM-YYYY
          schema:
            type: string
            example: 23-06-2026
        - name: duration
          in: query
          required: false
          description: Minutos por turno
          schema:
            type: integer
            example: 30
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvailableSlots'
components:
  schemas:
    AvailableSlots:
      type: object
      properties:
        status:
          type: boolean
        data:
          type: object
          properties:
            date:
              type: string
            doctor_id:
              type: integer
            duration_minutes:
              type: integer
            schedule:
              type: object
            available_slots:
              type: array
              items:
                type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'API key de la clínica. Header: Authorization: Bearer oclu_live_...'

````