> ## 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 se um valor está em alguma lista ativa do tipo informado para o tenant, útil para screening em tempo de execução — POST /data-lists/{type}/check.

## Visão geral

Executa **isInDataList** para o **tipo** informado. Útil para screening sem UUID de lista específico.

## Endpoint

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

## Autenticação

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

## Corpo da solicitação

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

## Resposta

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