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

# Consultar valor por tipo de lista

> Verifica si un valor está en alguna lista activa del tipo indicado para el tenant, útil para screening en tiempo de ejecución — POST /data-lists/{type}/check.

## Resumen

Ejecuta la búsqueda **isInDataList** para el **tipo** indicado (p. ej. `custom`, `company_blocklist`). Útil para screening en runtime sin fijar un UUID de lista.

## Endpoint

```
POST https://api.gu1.ai/data-lists/{type}/check
```

## Autenticación

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Cuerpo de la solicitud

<ParamField body="searchValue" type="any" required>
  Value to match (string, number, or structured object depending on type).
</ParamField>

<ParamField body="options" type="object">
  * `includeMetadata` (boolean): include match metadata in the response.
  * `useCache` (boolean): defaults to **true**; set `false` to bypass cache.
</ParamField>

## Respuesta

`found`, `listType`, `searchValue` (redacted when non-string), `matches`, `matchCount`, plus `performance` timing and optional `cacheHit`.