Skip to main content
GET
/
data-lists
/
{id}
/
items
List items in a data list
curl --request GET \
  --url http://api.gu1.ai/data-lists/{id}/items \
  --header 'Authorization: Bearer <token>'

​
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 (POST /data-lists/{id}/items/find).

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
page
number
default:"1"
Page number (1-based).
​
limit
number
default:"50"
Page size (capped at 50000 for export-style use cases).
​
search
string
Filter text (primary value / search keys).
​
category
string
Filter by category (empty string = all).

​
Response

{
  "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.