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

# List items in a data list

> Retrieve paginated items from a data list with optional full-text search and category filtering parameters — GET /data-lists/{id}/items.

## Overview

Returns items for a list, with pagination and optional **search** over primary value / indexed keys (service implementation).

For **targeted lookup by a single value** against `primary_value` and `search_keys` only (exact or contains), use **[Find items by value](/en/api-reference/data-lists/find-items)** (`POST /data-lists/{id}/items/find`).

## Endpoint

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

## Authentication

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

## Query Parameters

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

## Response

```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.