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

> Retorna todos os processos de assinatura com base em filtros opcionais.

## Parâmetros de Query

<ParamField query="title" type="string">
  Nome do envelope (processo). **Exemplo**: `Contrato`
</ParamField>

<ParamField query="code" type="string">
  Código do processo. **Exemplo**: `PRC-2023-001`
</ParamField>

<ParamField query="type" type="integer">
  Tipo do processo. **Exemplo**: `1`
</ParamField>

<ParamField query="signer_code" type="string">
  Código do signatário. **Exemplo**: `SIG001`
</ParamField>

<ParamField query="signer_name" type="string">
  Nome do signatário. **Exemplo**: `Maria Silva`
</ParamField>

<ParamField query="signer_email" type="string">
  Email do signatário. **Exemplo**: `maria@dominio.com`
</ParamField>

<ParamField query="signer_identifier" type="string">
  CPF/CNPJ do signatário. **Exemplo**: `12345678900`
</ParamField>

## Resposta

<ResponseField name="signature_processes" type="array">
  <Expandable title="Propriedades do Processo">
    <ResponseField name="uuid" type="string">
      UUID do processo.
    </ResponseField>

    <ResponseField name="code" type="string">
      Código externo do processo.
    </ResponseField>

    <ResponseField name="title" type="string">
      Título/Nome do processo.
    </ResponseField>

    <ResponseField name="type" type="integer">
      Tipo do processo.
    </ResponseField>

    <ResponseField name="state" type="integer">
      Estado atual (ex: Rascunho, Em andamento, Finalizado).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Data de criação.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Data da última atualização.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"theme":"catppuccin-latte"}
  {
    "signature_processes": [
      {
        "uuid": "8e3b2e50-8b9a-4d7a-9b8c-1e2f3a4b5c6d",
        "code": "PRC-2023-001",
        "title": "Contrato de Prestação de Serviços",
        "type": 1,
        "state": 1,
        "created_at": "2023-10-15T14:30:00Z",
        "updated_at": "2023-10-15T14:35:00Z"
      }
    ]
  }
  ```

  ```json 401 Não autenticado theme={"theme":"catppuccin-latte"}
  ```

  ```json 403 Não autorizado theme={"theme":"catppuccin-latte"}
  ```
</ResponseExample>