Skip to main content
GET
List data lists

Overview

Returns data lists visible to the tenant, with pagination and optional filters. Only direct child organizations in the same environment explicitly selected by the parent with PUT /data-lists/{id}/share-channels see the tenant list. Shared rows keep the parent’s list and item UUIDs and include origin: "parent", parentOrganizationId, parentOrganizationName, sharedEnabled, and readOnly: true. They become available to rules only after the child opts in with POST /data-lists/{id}/child-share and { "enabled": true }. Only the parent can edit the definition or its items.

Endpoint

Authentication

Query Parameters

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

Response

JSON with data (array of lists), pagination (total, limit, offset, page, totalPages), and summary counts for tabs. Each list includes origin, sharedEnabled, and readOnly; parent-owned lists also include parent organization metadata.