> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get data list by id or lists by type

> Retrieve a single data list by UUID or all active lists of a given type when a non-UUID identifier is supplied — GET /data-lists/{typeOrId}.

## 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

```bash theme={null}
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.