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

# Obter lista por UUID ou listas por tipo

> Recupera uma lista pelo UUID ou todas as listas ativas de determinado tipo quando o identificador não é UUID — GET /data-lists/{typeOrId}.

## Visão geral

* Se `{typeOrId}` for um **UUID**, retorna **uma** lista com esse id.
* Caso contrário, o segmento é tratado como **tipo** (ex.: `custom`, `company_blocklist`) e retorna **todas as listas ativas** desse tipo.

## Endpoint

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

## Autenticação

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Resposta

* **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.