Skip to main content
GET
Retrieve a booking event type

Uso

Usalo dentro de Bookable Payments para modelar inventario reservado, calcular disponibilidad, crear holds, convertirlos en checkout y confirmar bookings.

Antes de llamar

Patron recomendado

  • Ejecuta esta lectura desde backend cuando incluya datos privados del tenant.
  • Confirma inventario final con booking.confirmed o una lectura de booking, no solo con una URL de retorno.
  • Consulta el bloque OpenAPI de esta pagina para el shape exacto de parametros, body y respuestas.

Ejemplo minimo

terminal

Errores a manejar

  • 400 indica payload, parametros o estado invalido.
  • 401 o 403 indican API key, ambiente o scopes incorrectos.
  • 404 significa que el recurso no existe para ese tenant o ambiente.
  • 429 y 5xx se pueden reintentar con backoff; en writes conserva la misma idempotency key.

Contrato OpenAPI

El playground, parametros, body y respuestas de abajo salen de /openapi.json. Si el contrato cambia, actualiza la spec y regenera esta pagina.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id_or_slug
string
required

Response

200 - application/json

Booking event type

active
boolean
bookingFormFields
object[]
bookingWindowDays
integer
Required range: x >= 1
bufferAfterMinutes
integer
Required range: x >= 0
bufferBeforeMinutes
integer
Required range: x >= 0
cancellationPolicy
object
capacity
integer
Required range: x >= 1
confirmationPolicy
enum<string>
Available options:
automatic,
manual,
payment_required
defaultPrice
object
defaultPriceId
string<uuid>
description
string
durationChoicesMinutes
integer[]
Required range: x >= 1
durationMinutes
integer
Required range: x >= 1
id
string<uuid>
inventoryMode
enum<string>
Available options:
capacity_pool,
date_range,
instant,
seated,
unit_assignment
kind
enum<string>
Available options:
appointment,
class,
scheduled_offer,
experience,
rental,
service,
date_range
maximumQuantity
integer
Required range: x >= 1
metadata
object
minimumNoticeMinutes
integer
Required range: x >= 0
minimumQuantity
integer
Required range: x >= 1
object
any
paymentConfig
object
paymentRequirement
enum<string>
Available options:
deposit,
none,
optional,
required
product
object
productId
string<uuid>
reschedulePolicy
object
slug
string
slotIntervalMinutes
integer
Required range: x >= 1
timeZone
string
title
string
updatedAt
string<date-time>
Last modified on June 21, 2026