Skip to main content
GET
/
data-lists
/
{typeOrId}
Get data list by id or lists by type
curl --request GET \
  --url http://api.gu1.ai/data-lists/{typeOrId} \
  --header 'Authorization: Bearer <token>'

​
Overview

  • If {typeOrId} is a UUID, returns one list with that id (tenant-visible or allowed global).
  • Otherwise {typeOrId} is treated as a list type (e.g. custom, company_blocklist) and returns all active lists of that type.

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Response

  • By UUID: { "success": true, "data": { ...list } }
  • By type: { "success": true, "data": { "type", "lists", "total" } }
Errors: 400 invalid type, 404 list not found, 403 for marketplace-only lists not exposed via this API.