Skip to main content
GET
Ver una sesión

Authorizations

Authorization
string
header
required

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.

Headers

Craqui-Version
string

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

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-12-01"

Path Parameters

id
string
required

El id de la sesión (ses_…). Id de una sesión (una fecha de una clase).

Pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"ses_01hzx8m4k2a7d9q3f5w6y8z0bc"

Response

OK.

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.

id
string
required

Id de una sesión (una fecha de una clase).

Pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"ses_01hzx8m4k2a7d9q3f5w6y8z0bc"

object
string
required
Allowed value: "session"
livemode
boolean
required

false si el objeto es de tu estudio de prueba (claves crq_test_); true con claves crq_live_.

class_id
string
required

Id de una clase (el grupo con su horario semanal).

Pattern: ^cls_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"cls_01hzx8m4k2a7d9q3f5w6y8z0bc"

course_id
string
required

Id de una disciplina.

Pattern: ^crs_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"crs_01hzx8m4k2a7d9q3f5w6y8z0bc"

center_id
string | null
required

Id de una sede.

Pattern: ^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"ctr_01hzx8m4k2a7d9q3f5w6y8z0bc"

room_id
string | null
required

El salón de esta sesión, si tiene uno asignado.

Pattern: ^room_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"room_01hzx8m4k2a7d9q3f5w6y8z0bc"

teacher_id
string | null
required

Quien da esta sesión, con la suplencia aplicada (igual que el calendario del estudio). null si no tiene instructor asignado.

Pattern: ^tch_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"tch_01hzx8m4k2a7d9q3f5w6y8z0bc"

starts_at
string<date-time>
required

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.

Example:

"2026-11-05T19:00:00-03:00"

ends_at
string<date-time>
required

El fin. Una clase que cruza la medianoche termina al día siguiente.

Example:

"2026-11-05T19:00:00-03:00"

local_date
string<date>
required

Fecha local del negocio, YYYY-MM-DD.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-11-05"

local_start_time
string
required

Hora local del negocio, HH:MM (24 horas).

Pattern: ^\d{2}:\d{2}$
Example:

"19:00"

local_end_time
string
required

Hora local del negocio, HH:MM (24 horas).

Pattern: ^\d{2}:\d{2}$
Example:

"19:00"

time_zone
string | null
required

La zona horaria del estudio (IANA). null si el estudio no eligió una; los instantes salen en +00:00.

Example:

"America/Montevideo"

status
enum<string>
required

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.

Available options:
scheduled,
cancelled,
studio_closed
capacity
integer | null
required

El cupo de la sesión. null si la clase no tiene cupo.

booked_count
integer
required

Los lugares tomados: reservas confirmadas, asistidas y ausentes hasta que la sesión empieza. Es la misma cuenta que usa Craqui al reservar.

Required range: x >= 0
waitlist_count
integer
required

Cuántas personas esperan en la lista de espera.

Required range: x >= 0
available_spots
integer | null
required

capacity - booked_count, nunca menos de 0. null si la clase no tiene cupo.

Required range: x >= 0
created_at
string<date-time>
required

Instante en RFC 3339 con el offset del negocio en ese momento.

Example:

"2026-11-05T19:00:00-03:00"

updated_at
string<date-time>
required

Instante en RFC 3339 con el offset del negocio en ese momento.

Example:

"2026-11-05T19:00:00-03:00"