Find Lists
Find saved Lists in the selected Workspace. A restricted definition returns only recovery metadata, never an empty List. Use get_list_members for current members.
AuthorizationBearer <token>
Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.
In: header
Query Parameters
after?string
Length
1 <= length <= 4096limit?integer
Range
1 <= value <= 100Default
50status?string
Default
"active"Value in
- "active"
- "archived"
subject_type?string
Value in
- "business"
- "person"
Header Parameters
SMB-Workspace-Id*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/lists" \ -H "SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "lists": [ { "id": "string", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9", "name": "string", "description": "string", "definition": { "schema_version": "smb.list.v1", "subject_type": "business", "rule": { "kind": "field", "field": "name", "operator": "eq", "value": "string" } }, "version": 1, "lifecycle_status": "active", "count": { "status": "unknown", "value": null, "as_of": null }, "columns": [ { "column_id": "8f0515e3-00f6-4dd0-8153-321f1f40863d", "name": "string", "value_type": "text", "position": 0 } ] } ], "next_cursor": "string" }, "request_id": "string"}