# Módulo de Planes (Plans)

#### **Obtener listado paginado de planes**

Este módulo permite consultar los planes disponibles en el sistema mediante un listado paginado. El endpoint admite filtros opcionales para facilitar la búsqueda por ID, tipo de plan o término de búsqueda. La estructura de autenticación, paginación y formato de respuesta es consistente con los demás módulos públicos de la API.

**Función:** Devuelve un listado paginado de planes que puede ser filtrado por ID, tipo de plan o término de búsqueda.

[![image.png](https://v5.docs.airvi.com.co/uploads/images/gallery/2026-03/scaled-1680-/dhHQfIhaDJCZfJIu-image.png)](https://v5.docs.airvi.com.co/uploads/images/gallery/2026-03/dhHQfIhaDJCZfJIu-image.png)

##### Parámetros

<div class="TyagGW_tableContainer" id="bkmrk-par%C3%A1metro-tipo-oblig"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="987" data-start="607"><thead data-end="655" data-start="607"><tr data-end="655" data-start="607"><th class="" data-col-size="sm" data-end="619" data-start="607">Parámetro</th><th class="" data-col-size="sm" data-end="626" data-start="619">Tipo</th><th class="" data-col-size="sm" data-end="640" data-start="626">Obligatorio</th><th class="" data-col-size="sm" data-end="655" data-start="640">Descripción</th></tr></thead><tbody data-end="987" data-start="705"><tr data-end="754" data-start="705"><td data-col-size="sm" data-end="724" data-start="705">filters\[plan\_id\]</td><td data-col-size="sm" data-end="734" data-start="724">integer</td><td data-col-size="sm" data-end="739" data-start="734">No</td><td data-col-size="sm" data-end="754" data-start="739">ID del plan</td></tr><tr data-end="824" data-start="755"><td data-col-size="sm" data-end="776" data-start="755">filters\[plan\_type\]</td><td data-col-size="sm" data-end="785" data-start="776">string</td><td data-col-size="sm" data-end="790" data-start="785">No</td><td data-col-size="sm" data-end="824" data-start="790">Tipo de plan (ej. alojamiento)</td></tr><tr data-end="871" data-start="825"><td data-col-size="sm" data-end="834" data-start="825">search</td><td data-col-size="sm" data-end="843" data-start="834">string</td><td data-col-size="sm" data-end="848" data-start="843">No</td><td data-col-size="sm" data-end="871" data-start="848">Término de búsqueda</td></tr><tr data-end="928" data-start="872"><td data-col-size="sm" data-end="879" data-start="872">skip</td><td data-col-size="sm" data-end="889" data-start="879">integer</td><td data-col-size="sm" data-end="894" data-start="889">No</td><td data-col-size="sm" data-end="928" data-start="894">Cantidad de registros a omitir</td></tr><tr data-end="987" data-start="929"><td data-col-size="sm" data-end="936" data-start="929">take</td><td data-col-size="sm" data-end="946" data-start="936">integer</td><td data-col-size="sm" data-end="951" data-start="946">Sí</td><td data-col-size="sm" data-end="987" data-start="951">Cantidad de registros a retornar</td></tr></tbody></table>

</div></div>##### **Pasos para ejecutar la consulta**

1. Ingrese a `{BASE_URL}/api/public/v1/plans`.
2. Busque la sección **Plans → Obtener listado paginado de planes**.
3. En el campo **take**, escriba cuántos registros desea obtener.
4. Si desea aplicar filtros, agregue **plan\_id**, **plan\_type** o **search**.
5. Pulse **“Enviar petición”**.
6. Si la consulta es exitosa, recibirá un **200 OK** con los planes encontrados.
7. Si ocurre un problema durante la consulta, el endpoint retornará **500 INTERNAL\_ERROR**.

#### **Obtener listado de tipos de productos**

Este módulo permite consultar los tipos de productos disponibles en el sistema. El endpoint devuelve una lista de tipos de planes que pueden ser utilizados para clasificar los productos y mantiene la misma estructura de autenticación y formato de respuesta de los demás módulos públicos de la API.

Función: Devuelve una lista de los tipos de productos disponibles.

[![image.png](https://v5.docs.airvi.com.co/uploads/images/gallery/2026-03/scaled-1680-/b0Y4WoGVNv7yHqK3-image.png)](https://v5.docs.airvi.com.co/uploads/images/gallery/2026-03/b0Y4WoGVNv7yHqK3-image.png)

**Parámetros**  
Este endpoint no requiere parámetros para la consulta.

**Pasos para ejecutar la consulta**  
Ingrese a `{BASE_URL}/api/public/v1/plan_types`.  
Busque la sección **Plan Types → Obtener listado de tipos de productos**.  
Pulse **“Enviar petición”**.  
Si la consulta es exitosa, recibirá un **200 OK** con los tipos de productos disponibles.  
Si no se envía un token válido, el endpoint retornará **401 UNAUTHORIZED**.  
Si ocurre un problema durante la consulta, el endpoint retornará **500 INTERNAL\_ERROR**.