> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Solicitações de Liberação

> Listar solicitações pendentes e históricas de liberação de números de telefone

# Listar Solicitações de Liberação

Lista as solicitações de liberação enviadas para números de telefone em seu ambiente. Solicitações de liberação são usadas para devolver um número de telefone que você não precisa mais.

## Endpoint

```
GET /api/v1/phone-numbers/release-requests
```

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/phone-numbers/release-requests" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "request-uuid-1",
        "phone_number_id": "phone-uuid-1",
        "phone_number": "+5511987654321",
        "reason": "Number is no longer in use after migration",
        "status": "pending",
        "requested_at": "2024-01-10T14:30:00Z"
      },
      {
        "id": "request-uuid-2",
        "phone_number_id": "phone-uuid-2",
        "phone_number": "+5511976543210",
        "reason": "Replaced by new toll-free number",
        "status": "approved",
        "requested_at": "2024-01-05T10:00:00Z",
        "resolved_at": "2024-01-08T16:20:00Z"
      }
    ]
  }
  ```
</ResponseExample>

### Valores de Status

* `pending` — enviada, aguardando análise
* `approved` — aprovada e o número foi (ou será) liberado
* `rejected` — solicitação negada (motivo retornado no campo `rejection_reason`)
* `cancelled` — usuário cancelou antes da resolução

## Observações

* Para enviar uma nova solicitação de liberação, use [Solicitar Liberação de Telefone](/api-reference/endpoints/request-phone-release).
* Solicitações pendentes podem ser canceladas com [Cancelar Solicitação de Liberação](/api-reference/endpoints/cancel-release-request).