> ## 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 ítems de una lista

> Devuelve los ítems de una lista de forma paginada con parámetros opcionales de búsqueda de texto y filtro por categoría — GET /data-lists/{id}/items.

## Resumen

Devuelve ítems de una lista, con paginación y **search** opcional sobre valor principal / claves indexadas (según implementación del servicio).

Para **buscar un valor concreto** contra `primary_value` y `search_keys` (exacto o contiene), usá **[Buscar ítems por valor](/es/api-reference/data-lists/find-items)** (`POST /data-lists/{id}/items/find`).

## Endpoint

```
GET https://api.gu1.ai/data-lists/{id}/items
```

## Autenticación

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

## Parámetros de consulta

<ParamField query="page" type="number" default="1">
  Page number (1-based).
</ParamField>

<ParamField query="limit" type="number" default="50">
  Page size (capped at **50000** for export-style use cases).
</ParamField>

<ParamField query="search" type="string">
  Filter text (primary value / search keys).
</ParamField>

<ParamField query="category" type="string">
  Filter by category (empty string = all).
</ParamField>

## Respuesta

```json theme={null}
{
  "success": true,
  "items": [],
  "total": 0,
  "categories": [],
  "page": 1,
  "limit": 50,
  "totalPages": 0
}
```

`403` if the list is a **marketplace-only** global list not exposed via this API.