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

# Resultado da averbação

> Consulta o status do processamento assíncrono da averbação junto à DATAPREV

<Note>Etapa **obrigatória** — o resultado da averbação chega por webhook, com esta consulta como fallback.</Note>

A [averbação](/docs/e-consignado/averbacao) é processada de forma assíncrona. O resultado final chega de
duas formas complementares:

<CardGroup cols={2}>
  <Card title="Webhook de resultado" icon="bolt">
    `POST /webhooks/dataprev` — enviado para a URL configurada pelo parceiro assim que a DATAPREV processa
    a averbação.
  </Card>

  <Card title="Consulta de status (fallback)" icon="magnifying-glass">
    `GET /request/:requestId` — use quando o webhook não for recebido.
  </Card>
</CardGroup>

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/docs/primeiros-passos/authentication) para obter suas credenciais e gerar um token.
</Info>

<Note>
  A rota de consulta implementada é `GET /request/:requestId`. O bloco HATEOAS `_links.result` da resposta
  `202` referencia `/result/:requestId`, mas o endpoint que responde de fato é `/request/:requestId` — use
  este último.
</Note>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://hml.zipdin.com.br/dataprev-controller/request/e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456" \
    -H "x-api-key: SUA_API_KEY" \
    -H "Authorization: Bearer SEU_TOKEN"
  ```
</CodeGroup>

<ResponseExample>
  ```json 200 - Resultado theme={null}
  {
    "requestId": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
    "correlationId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "status": "completed"
  }
  ```
</ResponseExample>

## Tabela de Status

| Status       | Descrição                  | Final? | Ação do Cliente     |
| ------------ | -------------------------- | :----: | ------------------- |
| `queued`     | Requisição aceita, na fila |   Não  | Aguardar webhook    |
| `processing` | Em processamento           |   Não  | Aguardar webhook    |
| `completed`  | Sucesso                    |   Sim  | Processar resultado |
| `error`      | Falha definitiva           |   Sim  | Analisar erro       |
