> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar clearances

> Retorna todos os clearances com filtros opcionais, incluindo busca por UUID.

## Query Parameters

<ParamField query="uuid" type="string">
  UUID do clearance para filtrar resultados. **Exemplo**:
  `7604086b-cc97-4a2c-b928-7905fa4d6428`
</ParamField>

<ParamField query="name" type="string">
  Nome do clearance (busca parcial). **Exemplo**: `SERPRO ID`
</ParamField>

<ParamField query="slug" type="string">
  Slug do clearance. **Exemplo**: `serpro-id`
</ParamField>

## Response

<ResponseField name="clearances" type="array">
  Dados do clearance.

  <Expandable title="properties">
    <ResponseField name="uuid" type="string">
      UUID do clearance. **Exemplo**: `3fa85f64-5717-4562-b3fc-2c963f66afa6`
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome do clearance.
    </ResponseField>

    <ResponseField name="slug" type="string">
      Slug do clearance.
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição do clearance.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Data de criação. **Exemplo**: `2026-01-06T18:32:01.107Z`
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Data de atualização. **Exemplo**: `2026-01-06T18:32:01.107Z`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"theme":"catppuccin-latte"}
  {
    "clearances": [
      {
        "uuid": "7604086b-cc97-4a2c-b928-7905fa4d6428",
        "name": "SERPRO ID",
        "slug": "serpro-id",
        "description": "Validação via SERPRO ID",
        "created_at": "2023-10-10T14:00:00Z",
        "updated_at": "2023-10-10T14:00:00Z"
      }
    ]
  }
  ```

  ```json 500 Erro ao listar clearances theme={"theme":"catppuccin-latte"}
  {
    "message": "Erro ao listar clearances."
  }
  ```
</ResponseExample>