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

# Obtener lista por UUID o listas por tipo

> Obtiene una lista por UUID o todas las listas activas de un tipo cuando se pasa un identificador no-UUID — GET /data-lists/{typeOrId}.

## Resumen

* Si `{typeOrId}` es un **UUID**, devuelve **una** lista con ese id (visible para el tenant o global permitida).
* Si no es UUID, se interpreta como **tipo** de lista (p. ej. `custom`, `company_blocklist`) y devuelve **todas las listas activas** de ese tipo.

## Endpoint

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

## Autenticación

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

## Respuesta

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