---
title: "Consultar reservas activas por documento"
method: GET
path: "/api/v1/reservations/find_by"
tags: ["Consumos Externos"]
---

# Consultar reservas activas por documento

`GET /api/v1/reservations/find_by`

## Request

- Base URL: `https://aos.ayenda.co`
- URL: `https://aos.ayenda.co/api/v1/reservations/find_by`
- Auth: none required

Consulta las reservas activas de un huésped en un hotel, como paso previo para
registrarle un consumo externo. Se autentica con el API Key de integración externa
(header `X-Api-Key`).

Solo retorna reservas no canceladas en `checkin_registered` (huésped actualmente
hospedado): no aparecen las confirmadas sin check-in ni las que ya hicieron
check-out. Un huésped puede tener varias reservas activas en el mismo hotel; vienen
ordenadas de la llegada más reciente a la más antigua.

## Query parameters

- `hotel_id` integer, required
- `identification_number` string, required

## Headers

- `X-Api-Key` string, required

## Response `200`

ok

- object
  - `data` object[], required
    - `reservation_id` integer, required: ID de la reserva. Es el `hotel_reservation_id` que pide `POST /api/v1/external_consumptions`.
    - `start_at` string, date, required: Fecha de llegada. La fecha de un consumo debe caer entre `start_at` y `end_at`.
    - `end_at` string, date, required: Fecha de salida.
    - `guest_name` string, nullable, required: Nombre del huésped consultado.
    - `identification_number` string, nullable, required: Número de documento del huésped consultado, el mismo enviado en la consulta.
    - `room_names` string[], required: Habitaciones de la reserva. El `room_name` de un consumo debe ser una de ellas.

## Other responses

- `400`: bad request
- `401`: unauthorized
- `404`: not found

---

[API](https://skmtc.dev/loggro/apis/pms-api-v1.md) - [All operations](https://skmtc.dev/loggro/apis/pms-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/pms-api-v1/revisions/42f79a85a9d1?raw)