# Módulo de Ubicaciones

El módulo de **Ubicaciones (Locations)** permite acceder al listado de sedes o lugares registrados en el sistema. Este módulo también utiliza la misma estructura de autenticación, paginación y respuesta estándar de la API pública.

#### **Consultar listado paginado de ubicaciones**

**Función:** Obtiene un listado de ubicaciones con sus datos básicos, permitiendo aplicar filtros como ciudad, país o estado, además de paginar los resultados.

[![image.png](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/scaled-1680-/ZG0z33KfRgF9Z192-image.png)](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/ZG0z33KfRgF9Z192-image.png)

**Parámetros**

<div class="_tableContainer_1rjym_1" id="bkmrk-par%C3%A1metro-tipo-oblig"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1971" data-start="1542"><thead data-end="1590" data-start="1542"><tr data-end="1590" data-start="1542"><th data-col-size="sm" data-end="1554" data-start="1542">Parámetro</th><th data-col-size="sm" data-end="1561" data-start="1554">Tipo</th><th data-col-size="sm" data-end="1575" data-start="1561">Obligatorio</th><th data-col-size="sm" data-end="1590" data-start="1575">Descripción</th></tr></thead><tbody data-end="1971" data-start="1639"><tr data-end="1711" data-start="1639"><td class="align-left" data-col-size="sm" data-end="1655" data-start="1639">filters\[city\]</td><td class="align-left" data-col-size="sm" data-end="1664" data-start="1655">string</td><td class="align-left" data-col-size="sm" data-end="1669" data-start="1664">No</td><td class="align-left" data-col-size="sm" data-end="1711" data-start="1669">Ciudad de la ubicación. Ej: *San José*</td></tr><tr data-end="1787" data-start="1712"><td data-col-size="sm" data-end="1731" data-start="1712">filters\[country\]</td><td data-col-size="sm" data-end="1740" data-start="1731">string</td><td data-col-size="sm" data-end="1745" data-start="1740">No</td><td data-col-size="sm" data-end="1787" data-start="1745">País de la ubicación. Ej: *Costa Rica*</td></tr><tr data-end="1860" data-start="1788"><td data-col-size="sm" data-end="1806" data-start="1788">filters\[status\]</td><td data-col-size="sm" data-end="1815" data-start="1806">string</td><td data-col-size="sm" data-end="1820" data-start="1815">No</td><td data-col-size="sm" data-end="1860" data-start="1820">Estado de la ubicación. Ej: *activo*</td></tr><tr data-end="1914" data-start="1861"><td data-col-size="sm" data-end="1868" data-start="1861">skip</td><td data-col-size="sm" data-end="1878" data-start="1868">integer</td><td data-col-size="sm" data-end="1883" data-start="1878">No</td><td data-col-size="sm" data-end="1914" data-start="1883">Registros a omitir. Ej: 0</td></tr><tr data-end="1971" data-start="1915"><td data-col-size="sm" data-end="1922" data-start="1915">take</td><td data-col-size="sm" data-end="1932" data-start="1922">integer</td><td data-col-size="sm" data-end="1937" data-start="1932">Sí</td><td data-col-size="sm" data-end="1971" data-start="1937">Registros a retornar. Ej: *10*</td></tr></tbody></table>

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

1. Ingrese a: `{BASE_URL}/api/public/v1/locations`
2. Busque la sección **locations → Listado de ubicaciones**.
3. Si desea filtrar, complete los campos:
    
    
    - Ciudad
    - País
    - Estado
    - skip
    - take (obligatorio)
4. Pulse **“Enviar petición”**.
5. Si existen registros, recibirá un **200 OK** con los datos de cada ubicación.
6. Si ocurre un error interno, la API responderá con **500 INTERNAL\_ERROR**.