> ## 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 un evento > Un evento del estudio de los últimos 30 días. Responde `not_found` si es de otro negocio, si tiene más de 30 días o si su recurso no lo puede leer tu clave. 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 /events/{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 `. 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. - name: events description: > Lo que cambió en el estudio en los últimos 30 días, para enterarte sin consultar cada lista. Solo estudios. paths: /events/{id}: get: tags: - events summary: Ver un evento description: > Un evento del estudio de los últimos 30 días. Responde `not_found` si es de otro negocio, si tiene más de 30 días o si su recurso no lo puede leer tu clave. Solo para estudios: en una academia responde `wrong_vertical`. Un parámetro que la ruta no declara responde `validation_failed` con `unknown_parameter`. operationId: getEvent parameters: - $ref: '#/components/parameters/CraquiVersion' - $ref: '#/components/parameters/EventIdPath' 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/Event' example: id: evt_79p14jhbsm8gaaj1bwvqa5jfg5 object: event type: booking.attended created_at: '2026-12-01T09:05:12-03:00' livemode: true data: object_id: bkg_01j5cceh8fkntbjm406cvh2kwm object_type: booking previous_attributes: status: confirmed '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' EventIdPath: name: id in: path required: true description: El id del evento (`evt_…`). schema: $ref: '#/components/schemas/EventId' 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: Event: type: object description: > Algo que cambió en tu estudio: una reserva, una sesión, un cliente, un pago. Trae qué cambió y el id del objeto, nunca sus datos: para ver cómo quedó, pide el objeto con su ruta (`GET /bookings/{id}`, por ejemplo) y el permiso de ese recurso. Un mismo evento puede llegarte más de una vez y no hay un orden garantizado entre eventos: usa `id` para no procesarlo dos veces. required: - id - object - type - created_at - livemode - data - previous_attributes properties: id: $ref: '#/components/schemas/EventId' object: type: string const: event type: type: string description: > Qué pasó, como `.`. La lista puede crecer: ignora un tipo que no conoces. - Clientes: `client.created`, `client.updated` (nombre, contacto o sede), `client.deactivated`, `client.reactivated`. - Reservas: `booking.created` (también al volver a reservar una reserva cancelada), `booking.cancelled`, `booking.waitlisted`, `booking.promoted` (de la lista de espera a la clase), `booking.attended`, `booking.no_show`, `booking.attendance_undone`. - Sesiones: `session.created`, `session.cancelled` (también por un cierre del estudio), `session.restored`, `session.deleted`, `session.rescheduled`, `session.teacher_changed`. - Créditos: `credit_grant.created`, `credit_grant.revoked`, `credit_grant.expired`. - Membresías: `membership.created`, `membership.activated`, `membership.renewed`, `membership.suspended`, `membership.cancellation_scheduled`, `membership.cancellation_undone`, `membership.ended`, `membership.frozen`, `membership.unfrozen`. - Cobros: `fee.created`, `fee.overdue`, `fee.paid`, `payment.created`, `refund.created`. Dos cambios iguales del mismo objeto en una misma operación dejan un solo evento. enum: - client.created - client.updated - client.deactivated - client.reactivated - booking.created - booking.cancelled - booking.waitlisted - booking.promoted - booking.attended - booking.no_show - booking.attendance_undone - session.created - session.cancelled - session.restored - session.deleted - session.rescheduled - session.teacher_changed - credit_grant.created - credit_grant.revoked - credit_grant.expired - membership.created - membership.activated - membership.renewed - membership.suspended - membership.cancellation_scheduled - membership.cancellation_undone - membership.ended - membership.frozen - membership.unfrozen - fee.created - fee.overdue - fee.paid - payment.created - refund.created x-extensible-enum: true created_at: $ref: '#/components/schemas/Instant' livemode: type: boolean description: >- `false` si el objeto es de tu estudio de prueba (claves `crq_test_`); `true` con claves `crq_live_`. Hoy tu estudio de prueba no genera eventos. data: $ref: '#/components/schemas/EventData' previous_attributes: type: object description: > Los valores públicos que el objeto tenía antes del cambio, solo los que cambiaron y tienen forma pública: `status` en reservas, clientes, sesiones, membresías y cuotas; `waitlist_position` en `booking.promoted`; `starts_at` y `ends_at` en `session.rescheduled`; `current_period_start` y `current_period_end` en `membership.renewed`. Vacío (`{}`) si no hay nada que contar. Nunca trae datos personales: `client.updated` no dice qué tenía antes. properties: status: type: string description: >- El estado anterior, con los mismos valores que el campo `status` del objeto. waitlist_position: type: - integer - 'null' starts_at: $ref: '#/components/schemas/Instant' ends_at: $ref: '#/components/schemas/Instant' current_period_start: $ref: '#/components/schemas/Instant' current_period_end: $ref: '#/components/schemas/Instant' EventId: type: string description: Id de un evento. pattern: ^evt_[0-7][0-9a-hjkmnp-tv-z]{25}$ examples: - evt_79p14jhbsm8gaaj1bwvqa5jfg5 Instant: type: string format: date-time description: Instante en RFC 3339 con el offset del negocio en ese momento. examples: - '2026-12-02T19:00:00-03:00' EventData: type: object required: - object_id - object_type properties: object_id: type: string description: >- El id público del objeto, con el prefijo de su recurso (`bkg_…`, `ses_…`, `cli_…`). pattern: ^(cli|bkg|ses|cgr|mem|fee|pay|rfd)_[0-7][0-9a-hjkmnp-tv-z]{25}$ object_type: type: string description: >- El recurso: `client`, `booking`, `session`, `credit_grant`, `membership`, `fee`, `payment` o `refund`. La lista puede crecer. enum: - client - booking - session - credit_grant - membership - fee - payment - refund x-extensible-enum: true 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` y `event_type_not_permitted`. 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`, `event_type_not_permitted` (eventos de un recurso que la clave no puede leer; `required_scope` dice cuál) y `write_access_disabled` (en una ruta que crea o cambia datos, si tu negocio no tiene habilitada la escritura por la API). 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.