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

# Ver una sesión

> Una sesión de una clase del estudio, también si está cancelada (`status: cancelled`). Una sesión de un
workshop responde `not_found`.

        Solo para estudios: en una academia responde `wrong_vertical`. Un parámetro que la ruta no
        declara responde `validation_failed` con `unknown_parameter`.




## OpenAPI

````yaml /openapi.yaml get /sessions/{id}
openapi: 3.1.0
info:
  title: API de Craqui
  version: '2026-12-01'
  summary: Conecta tu web o tu sistema a tu estudio o academia en Craqui.
  description: >
    API REST de Craqui. Cada clave pertenece a un solo negocio (un estudio o una
    academia) y todo lo

    que devuelve es de ese negocio.


    - **Autenticación:** `Authorization: Bearer <clave>`. Las claves se crean en
    Configuración →
      Integraciones. Una clave `crq_live_` usa los datos reales del negocio; una `crq_test_` usa su
      estudio de prueba: la misma configuración (sedes, clases, packs, planes) con clientes y
      reservas de ejemplo, que no le escribe a nadie. La URL es la misma: el entorno lo decide la
      clave. Todo objeto dice en `livemode` de cuál de los dos viene.
    - **Versión:** cada clave queda fijada a la versión vigente cuando se creó.
    El header
      `Craqui-Version` la sobrescribe por pedido, y la respuesta siempre dice cuál se usó.
    - **Errores:** `application/problem+json` (RFC 9457), con un `code` estable
    para programar y un
      `request_id` para buscar el pedido en tu panel.
    - **Montos:** enteros en `amount_cents` (siempre ×100) junto con la moneda
    ISO 4217.

    - **Fechas y horas:** instantes en RFC 3339 con el offset del negocio;
    fechas sin hora como
      `YYYY-MM-DD` en la fecha local del negocio.
  contact:
    name: Craqui
    url: https://craqui.com
servers:
  - url: https://api.craqui.com/v1
    description: Producción
security:
  - bearerAuth: []
tags:
  - name: business
    description: El negocio al que pertenece la clave (un estudio o una academia).
  - name: booking_policy
    description: Las reglas de reserva del estudio. Solo estudios.
  - name: centers
    description: Las sedes del estudio. Solo estudios.
  - name: rooms
    description: Los salones de cada sede. Solo estudios.
  - name: teachers
    description: Quienes dan clases en el estudio. Solo estudios.
  - name: courses
    description: Las disciplinas del estudio (Yoga, Pilates…). Solo estudios.
  - name: classes
    description: Las clases con su horario semanal. Solo estudios.
  - name: sessions
    description: El horario del estudio, sesión por sesión, con sus lugares. Solo estudios.
  - name: clients
    description: >-
      Los clientes del estudio, con el contacto separado en su propio permiso.
      Solo estudios.
  - name: bookings
    description: Las reservas de las sesiones. Solo estudios.
  - name: credit_packs
    description: Los packs de créditos que vende el estudio. Solo estudios.
  - name: membership_plans
    description: Los planes de membresía que vende el estudio. Solo estudios.
  - name: intro_offers
    description: Las ofertas de bienvenida que vende el estudio. Solo estudios.
  - name: credits
    description: Los créditos de los clientes, sus lotes y sus movimientos. Solo estudios.
  - name: memberships
    description: Las membresías de los clientes y sus congelamientos. Solo estudios.
  - name: fees
    description: Las cuotas que el estudio le cobra a cada cliente. Solo estudios.
  - name: payments
    description: Los pagos de las cuotas. Solo estudios.
  - name: refunds
    description: Los reembolsos de los pagos. Solo estudios.
paths:
  /sessions/{id}:
    get:
      tags:
        - sessions
      summary: Ver una sesión
      description: >
        Una sesión de una clase del estudio, también si está cancelada (`status:
        cancelled`). Una sesión de un

        workshop responde `not_found`.

                Solo para estudios: en una academia responde `wrong_vertical`. Un parámetro que la ruta no
                declara responde `validation_failed` con `unknown_parameter`.
      operationId: getSession
      parameters:
        - $ref: '#/components/parameters/CraquiVersion'
        - $ref: '#/components/parameters/SessionIdPath'
      responses:
        '200':
          description: OK.
          headers:
            Request-Id:
              $ref: '#/components/headers/RequestId'
            Craqui-Version:
              $ref: '#/components/headers/CraquiVersion'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    CraquiVersion:
      name: Craqui-Version
      in: header
      required: false
      description: >
        Versión de la API para este pedido (`YYYY-MM-DD`). Si no la mandas, se
        usa la versión fijada en

        la clave cuando se creó.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        examples:
          - '2026-12-01'
    SessionIdPath:
      name: id
      in: path
      required: true
      description: El id de la sesión (`ses_…`).
      schema:
        $ref: '#/components/schemas/SessionId'
  headers:
    RequestId:
      description: Identificador del pedido. Aparece también en el cuerpo de los errores.
      schema:
        type: string
        pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
    CraquiVersion:
      description: La versión de la API con la que se respondió.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
    RateLimit:
      description: >-
        Pedidos que quedan en la ventana actual y segundos hasta que se renueva
        (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";r=97;t=42'
    RateLimitPolicy:
      description: Límite de la clave por ventana (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";q=100;w=60'
    RetryAfter:
      description: Segundos que hay que esperar antes de reintentar.
      schema:
        type: integer
        minimum: 0
  schemas:
    Session:
      type: object
      description: >
        Una sesión: una fecha de una clase, con su horario, quién la da y sus
        lugares. Solo sesiones de

        clases: los workshops no están en esta versión.
      required:
        - id
        - object
        - livemode
        - class_id
        - course_id
        - center_id
        - room_id
        - teacher_id
        - starts_at
        - ends_at
        - local_date
        - local_start_time
        - local_end_time
        - time_zone
        - status
        - capacity
        - booked_count
        - waitlist_count
        - available_spots
        - created_at
        - updated_at
      properties:
        id:
          $ref: '#/components/schemas/SessionId'
        object:
          type: string
          const: session
        livemode:
          type: boolean
          description: >-
            `false` si el objeto es de tu estudio de prueba (claves
            `crq_test_`); `true` con claves `crq_live_`.
        class_id:
          $ref: '#/components/schemas/ClassId'
        course_id:
          $ref: '#/components/schemas/CourseId'
        center_id:
          oneOf:
            - $ref: '#/components/schemas/CenterId'
            - type: 'null'
        room_id:
          description: El salón de esta sesión, si tiene uno asignado.
          oneOf:
            - $ref: '#/components/schemas/RoomId'
            - type: 'null'
        teacher_id:
          description: >
            Quien da esta sesión, con la suplencia aplicada (igual que el
            calendario del estudio). `null`

            si no tiene instructor asignado.
          oneOf:
            - $ref: '#/components/schemas/TeacherId'
            - type: 'null'
        starts_at:
          $ref: '#/components/schemas/Instant'
          description: >
            El inicio, con el offset del estudio en ese momento. Una hora local
            que no existe por el

            cambio de horario (por ejemplo 00:30 la noche en que se adelanta el
            reloj) se corre una hora,

            igual que al reservar: en ese caso `starts_at` y `local_start_time`
            no coinciden.
        ends_at:
          $ref: '#/components/schemas/Instant'
          description: El fin. Una clase que cruza la medianoche termina al día siguiente.
        local_date:
          $ref: '#/components/schemas/LocalDate'
        local_start_time:
          $ref: '#/components/schemas/LocalTime'
        local_end_time:
          $ref: '#/components/schemas/LocalTime'
        time_zone:
          type:
            - string
            - 'null'
          description: >-
            La zona horaria del estudio (IANA). `null` si el estudio no eligió
            una; los instantes salen en `+00:00`.
          examples:
            - America/Montevideo
        status:
          type: string
          description: >
            `scheduled`, `cancelled` (el estudio la canceló) o `studio_closed`
            (el estudio cerró ese día).

            La lista puede crecer: trata un valor que no conoces como una sesión
            que no se da.
          enum:
            - scheduled
            - cancelled
            - studio_closed
          x-extensible-enum: true
        capacity:
          type:
            - integer
            - 'null'
          description: El cupo de la sesión. `null` si la clase no tiene cupo.
        booked_count:
          type: integer
          description: >
            Los lugares tomados: reservas confirmadas, asistidas y ausentes
            hasta que la sesión empieza. Es

            la misma cuenta que usa Craqui al reservar.
          minimum: 0
        waitlist_count:
          type: integer
          description: Cuántas personas esperan en la lista de espera.
          minimum: 0
        available_spots:
          type:
            - integer
            - 'null'
          description: >-
            `capacity - booked_count`, nunca menos de 0. `null` si la clase no
            tiene cupo.
          minimum: 0
        created_at:
          $ref: '#/components/schemas/Instant'
        updated_at:
          $ref: '#/components/schemas/Instant'
    SessionId:
      type: string
      description: Id de una sesión (una fecha de una clase).
      pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - ses_01hzx8m4k2a7d9q3f5w6y8z0bc
    ClassId:
      type: string
      description: Id de una clase (el grupo con su horario semanal).
      pattern: ^cls_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - cls_01hzx8m4k2a7d9q3f5w6y8z0bc
    CourseId:
      type: string
      description: Id de una disciplina.
      pattern: ^crs_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - crs_01hzx8m4k2a7d9q3f5w6y8z0bc
    CenterId:
      type: string
      description: Id de una sede.
      pattern: ^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - ctr_01hzx8m4k2a7d9q3f5w6y8z0bc
    RoomId:
      type: string
      description: Id de un salón.
      pattern: ^room_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - room_01hzx8m4k2a7d9q3f5w6y8z0bc
    TeacherId:
      type: string
      description: Id de un instructor.
      pattern: ^tch_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - tch_01hzx8m4k2a7d9q3f5w6y8z0bc
    Instant:
      type: string
      format: date-time
      description: Instante en RFC 3339 con el offset del negocio en ese momento.
      examples:
        - '2026-11-05T19:00:00-03:00'
    LocalDate:
      type: string
      format: date
      description: Fecha local del negocio, `YYYY-MM-DD`.
      pattern: ^\d{4}-\d{2}-\d{2}$
      examples:
        - '2026-11-05'
    LocalTime:
      type: string
      description: Hora local del negocio, `HH:MM` (24 horas).
      pattern: ^\d{2}:\d{2}$
      examples:
        - '19:00'
    Problem:
      type: object
      description: >
        Un error. Programa contra `code`, que no cambia; `title` y `detail` son
        para mostrarle a una

        persona y pueden cambiar de redacción.
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
          format: uri
          description: URL de la página de la documentación de este error.
          examples:
            - https://docs.craqui.com/errors/invalid_api_key
        title:
          type: string
          description: Resumen corto, en español.
          examples:
            - La clave no es válida
        status:
          type: integer
          description: El mismo código HTTP de la respuesta.
          examples:
            - 401
        code:
          type: string
          description: >
            Código estable del error. La lista puede crecer: trata un `code` que
            no conoces como un

            error genérico de su `status`.
          examples:
            - invalid_api_key
        detail:
          type: string
          description: Qué pasó y qué hacer, en español.
          examples:
            - >-
              Revisa que copiaste la clave completa, incluido el prefijo
              (crq_live_ o crq_test_).
        request_id:
          type: string
          pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
          description: >-
            Identificador del pedido. Búscalo en Configuración → Integraciones →
            Actividad de la API.
          examples:
            - req_01hzx8m4k2a7d9q3f5w6y8z0bc
        doc_url:
          type: string
          format: uri
          description: >-
            Igual a `type`, por compatibilidad con clientes que buscan este
            campo.
        required_scope:
          type: string
          description: Solo en `scope_required`. El permiso que le falta a la clave.
          examples:
            - business:read
        errors:
          type: array
          description: Solo en errores de validación. Un elemento por campo con problemas.
          items:
            $ref: '#/components/schemas/FieldError'
    FieldError:
      type: object
      required:
        - field
        - code
      properties:
        field:
          type: string
          description: El campo, como lo mandaste (por ejemplo `session_id`).
          examples:
            - session_id
        code:
          type: string
          description: Qué tiene mal el campo.
          examples:
            - invalid_prefix
        detail:
          type: string
          description: Explicación en español.
  responses:
    BadRequest:
      description: >
        El pedido está mal formado. Códigos posibles: `invalid_api_version`,
        `idempotency_key_required`,

        `validation_failed` (con un elemento de `errors` por parámetro:
        `unknown_parameter`,

        `invalid_prefix`, `invalid_id`, `invalid_date`, `invalid_boolean`,
        `invalid_enum`,

        `invalid_limit`, `duplicate_parameter`, `expand_not_supported`…) e
        `invalid_cursor` (un

        `starting_after` de otra búsqueda: repite la primera página con los
        mismos filtros). El detalle

        de un error nunca repite el valor que mandaste.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unauthorized:
      description: >
        Falta la clave o no sirve. Códigos posibles: `missing_api_key`,
        `invalid_api_key`,

        `revoked_api_key`, `expired_api_key`, `legacy_api_key`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            revoked:
              value:
                type: https://docs.craqui.com/errors/revoked_api_key
                title: La clave fue revocada
                status: 401
                code: revoked_api_key
                detail: Crea una clave nueva en Configuración → Integraciones.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    Forbidden:
      description: >
        La clave es válida pero no puede hacer esto. Códigos posibles:
        `scope_required`,

        `plan_required`, `api_key_suspended`, `browser_not_allowed`,
        `wrong_vertical`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    NotFound:
      description: >-
        No existe, o no es de tu negocio. Código `not_found` o
        `route_not_found`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Conflict:
      description: >
        Solo con una clave `crq_test_`: tu estudio de prueba no está listo.
        Código

        `sandbox_unavailable`. Restablece tus datos de prueba en Configuración →
        Integraciones y vuelve

        a intentar. Una clave de prueba nunca responde con los datos reales del
        negocio.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            sandbox_unavailable:
              value:
                type: https://docs.craqui.com/errors/sandbox_unavailable
                title: Tu estudio de prueba no está listo
                status: 409
                code: sandbox_unavailable
                detail: >-
                  Restablece tus datos de prueba en Configuración →
                  Integraciones y vuelve a intentar.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    TooManyRequests:
      description: >-
        Se pasó el límite de pedidos por minuto de la clave. Código
        `rate_limited`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        RateLimit:
          $ref: '#/components/headers/RateLimit'
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    InternalError:
      description: >-
        Falló algo de nuestro lado. Código `internal_error`. Reintenta; si
        sigue, escríbenos con el `request_id`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: crq_live_sk_… / crq_live_rk_…
      description: >
        Clave del negocio. `sk` es una clave completa (todo lo que el rol de
        quien la creó puede dar)

        y `rk` una restringida a los permisos que se eligieron al crearla. Solo
        se usa desde un

        servidor: un pedido desde un navegador se rechaza con
        `browser_not_allowed`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.