> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/contratos/encerramento/consultar-status.md).

# Acompanhar o Encerramento

O encerramento de contrato **não tem endpoint de status próprio**. Ele é uma operação FGTS como as demais: use o `requestId` devolvido no `202` da [submissão](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/contratos/encerramento/submeter-solicitacao.md) no acompanhamento padrão de operações.

## Request

`GET /api/v1/fgts/operations/{requestId}`

Autenticado: `Authorization: Bearer {originatorToken}`. Ver a referência completa em [Consultar status da operação](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/operacoes-fgts/acompanhar-resultado/consultar-status-operacao.md).

{% hint style="info" %}
O endpoint responde `200` **desde o registro**, inclusive enquanto a solicitação aguarda a autorização interna da Giro — nessa fase o `status` é `PENDING_MANUAL_APPROVAL`. Apenas o originator dono do contrato consegue consultá-la.
{% endhint %}

## Estados

| `status`                  | Significado                                                                                                                                                                                                    |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PENDING_MANUAL_APPROVAL` | Não-terminal. A solicitação está em **análise interna da Giro** e ainda não foi enviada à Caixa.                                                                                                               |
| `COMPLETED`               | Terminal. Desaverbação concluída na Caixa. O `result` traz um `ProtocolResult` (`protocolNumber`, `protocolStatus`, `detail`).                                                                                 |
| `FAILED`                  | Terminal. Rejeitada na análise interna da Giro ou negada pela Caixa. O `error` traz um `OperationError` — ver [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros.md#operationerror). |

O `status` é **normalizado** para o originator: as etapas internas da análise não são expostas, todas aparecem como `PENDING_MANUAL_APPROVAL`.

## Exemplo

### Em análise interna

```http
GET /api/v1/fgts/operations/a1b2c3d4-58cc-4372-a567-0e02b2c3d479 HTTP/1.1
Host: ingress.gtfgts.staging.giro.tech
Authorization: Bearer {originatorToken}
```

```json
{
  "requestId": "a1b2c3d4-58cc-4372-a567-0e02b2c3d479",
  "status": "PENDING_MANUAL_APPROVAL",
  "result": null,
  "error": null
}
```

### Concluído

```json
{
  "requestId": "a1b2c3d4-58cc-4372-a567-0e02b2c3d479",
  "status": "COMPLETED",
  "result": {
    "protocolNumber": "20260813000012345",
    "protocolStatus": "ACCEPTED",
    "detail": "Desaverbação registrada na Caixa."
  },
  "error": null
}
```

## Prefira o webhook ao polling

O desfecho é entregue por webhook nos eventos `CANCEL_RESERVE_*` — `CANCEL_RESERVE_UNDER_REVIEW` (intermediário, quando entra em revisão manual), `CANCEL_RESERVE_COMPLETED`, `CANCEL_RESERVE_FAILED` e `CANCEL_RESERVE_NEEDS_VERIFICATION`. O `requestId` do payload é o mesmo do `202`. Ver [Eventos](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/eventos.md) e [Payloads](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/payloads.md).

Use o polling como complemento — para reconciliação ou quando o webhook não estiver configurado —, não como mecanismo principal.
