> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar data lists

> Catálogo paginado de listas del tenant con agrupación por pestañas, filtros por tipo y estado, y contadores de resumen — GET /data-lists.

## Resumen

Devuelve las data lists visibles para el tenant, con paginación y filtros opcionales.

## Endpoint

```
GET https://api.gu1.ai/data-lists
```

## Autenticación

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Parámetros de consulta

<ParamField query="tab" type="string">
  `all` (default), `global`, `custom`, or `archived` — presets for `isGlobal` / `status`.
</ParamField>

<ParamField query="status" type="string">
  `active`, `inactive`, `draft`, `archived` — can override tab defaults where allowed.
</ParamField>

<ParamField query="isGlobal" type="boolean">
  Filter global vs tenant lists.
</ParamField>

<ParamField query="search" type="string">
  Free-text search on list metadata (implementation-specific).
</ParamField>

<ParamField query="type" type="string">
  Filter by list type (same enum as create).
</ParamField>

<ParamField query="source" type="string">
  Filter by source enum.
</ParamField>

<ParamField query="limit" type="number">
  Page size (default 15, max 1000).
</ParamField>

<ParamField query="offset" type="number">
  Offset for pagination (default 0).
</ParamField>

<ParamField query="orderBy" type="string">
  `name`, `createdAt`, or `updatedAt`.
</ParamField>

<ParamField query="orderDirection" type="string">
  `asc` or `desc` (default `desc`).
</ParamField>

## Respuesta

JSON with `data` (array of lists), `pagination` (`total`, `limit`, `offset`, `page`, `totalPages`), and `summary` counts for tabs.