> ## 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 motivos de recusa

> Lista os motivos pré-definidos que o signatário pode escolher ao recusar a assinatura.

Lista os motivos pré-definidos de recusa de assinatura disponíveis para o signatário. Use esta chamada para exibir um menu de opções ao signatário antes de chamar o endpoint de recusa.

**Autenticação**: use apenas o `sessionToken` na URL — nenhum header de autenticação é necessário.

## Parâmetros

<ParamField path="sessionToken" type="string" required>
  Token único da sessão do signatário.
</ParamField>

## Respostas

Array de objetos `RefusalReason`:

<ResponseField name="id" type="integer">
  Identificador numérico do motivo. Use este valor em [`POST .../refuse`](/plataforma/assinatura-digital/api/post-sign-session-refuse).
</ResponseField>

<ResponseField name="description" type="string">
  Descrição legível do motivo, ex.: `"Documento incorreto"`, `"Dados incompletos"`.
</ResponseField>

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **404**: Sessão não encontrada.
* **410**: Session token expirado.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  [
    {
      "id": 1,
      "description": "Documento incorreto"
    },
    {
      "id": 2,
      "description": "Dados incompletos"
    },
    {
      "id": 3,
      "description": "Preciso de mais tempo"
    },
    {
      "id": 4,
      "description": "Já não concordo com os termos"
    },
    {
      "id": 5,
      "description": "Motivo não listado"
    }
  ]
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 410 Gone
  Content-Type: application/json

  {
    "statusCode": 410,
    "message": "Session expired"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X GET "https://api.valid.com/signer/v1/sign/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.../refusal-reasons" \
  -H "Content-Type: application/json"
```

## Importante

* **Texto livre sempre oferecido**: além das opções desta lista, a interface do signatário sempre oferece a possibilidade de digitar um motivo em texto livre (ex.: "Outros motivos"). Esse texto livre não vem desta lista — é capturado diretamente no formulário de recusa.
* **IDs numérricos**: cada motivo tem um `id` — use-o ao chamar [`POST .../refuse`](/plataforma/assinatura-digital/api/post-sign-session-refuse).

## Próximas etapas

1. Exiba os motivos desta lista como opções (ex.: botões, radio buttons, dropdown).
2. Se o signatário selecionar "Motivo não listado" ou digitar texto livre, capture-o.
3. Chame [`POST .../refuse`](/plataforma/assinatura-digital/api/post-sign-session-refuse) com o motivo (id ou texto).

## Relacionado

* [`POST /signer/v1/sign/:sessionToken/refuse`](/plataforma/assinatura-digital/api/post-sign-session-refuse) — recusar assinatura com motivo
* [`GET /signer/v1/sign/:sessionToken`](/plataforma/assinatura-digital/api/get-sign-session) — obter dados da sessão


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.