Consultar habitaciones libres
Para una estadía (llegada, salida y huéspedes), cada tipo de habitación
en venta con las habitaciones libres todas esas noches y el precio de la
estadía noche por noche, como lo calcula la página pública de
alojamiento: tarifas y temporadas, descuento por estadía larga,
huéspedes extra, cargos únicos e impuesto de hospedaje. Si el tipo no
recibe la estadía, refusal dice por qué y price es null. Incluye
los tipos que el negocio no muestra en su página. Reserva una con
POST /stays. Las noches se nombran por el día en que empiezan.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Query parameters
El día de llegada (AAAA-MM-DD).
El día de salida (AAAA-MM-DD).
Solo este tipo de habitación.
Response
Los tipos de habitación
Por qué el tipo no recibe la estadía.