Skip to main content
GET
/
data-lists
List data lists
curl --request GET \
  --url http://api.gu1.ai/data-lists \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns data lists visible to the tenant, with pagination and optional filters.

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
tab
string
all (default), global, custom, or archived — presets for isGlobal / status.
​
status
string
active, inactive, draft, archived — can override tab defaults where allowed.
​
isGlobal
boolean
Filter global vs tenant lists.
​
search
string
Free-text search on list metadata (implementation-specific).
​
type
string
Filter by list type (same enum as create).
​
source
string
Filter by source enum.
​
limit
number
Page size (default 15, max 1000).
​
offset
number
Offset for pagination (default 0).
​
orderBy
string
name, createdAt, or updatedAt.
​
orderDirection
string
asc or desc (default desc).

​
Response

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