---
title: "Consultar hotel por número de documento"
method: GET
path: "/api/v1/hotels/find_by"
tags: ["Consumos Externos"]
---

# Consultar hotel por número de documento

`GET /api/v1/hotels/find_by`

## Request

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

Consulta los hoteles registrados con un número de documento, para resolver el
`hotel_id` que pide `GET /api/v1/reservations/find_by`. Retorna una lista porque
varios hoteles pueden estar registrados con el mismo documento.

Incluye todos los hoteles que coinciden, sin importar su estado ni su estado de venta
(incluso suspendidos o de prueba), para que el integrador vea el estado del hotel o
haga pruebas con el hotel de pruebas. Se autentica con el API Key de integración
externa (header `X-Api-Key`).

## Query parameters

- `hotel_document_number` string, required

## Headers

- `X-Api-Key` string, required

## Response `200`

ok

- object
  - `data` object[], required
    - `hotel_id` integer, required: ID del hotel. Es el `hotel_id` que pide `GET /api/v1/reservations/find_by`.
    - `name` string, required: Nombre del hotel.
    - `status` string, required: Estado del hotel en el PMS: `active`, `inactive` o `deleted`.
    - `address` string, required: Dirección del hotel.
    - `document` string, required: Número de documento de la persona natural o jurídica dueña del hotel.
    - `document_type` string, required: Tipo de documento: `CC`, `NIT`, `DNI`, `INE`, `CURP`, `CE` o `Passport`.

## 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)