Consultar status

Requisição#

Substitua SEND_ID pelo ID guardado no seu servidor. Envie a chave no cabeçalho Authorization.

curl "https://api.aut2fa.com/v1/send/$SEND_ID/status" \
  -H "Authorization: Bearer $AUT2FA_API_KEY"

Resposta 200#

{
  "id": "snd_01m4prwckhd0kyjgv5vw8a5wjr",
  "status": "read",
  "verification": "pending",
  "mode": "test",
  "channel": "sandbox",
  "from": null,
  "expires_at": "2026-10-11T15:10:00Z",
  "created_at": "2026-10-11T15:00:00Z",
  "sent_at": "2026-10-11T15:00:01Z",
  "delivered_at": "2026-10-11T15:00:01Z",
  "read_at": "2026-10-11T15:00:01Z",
  "verified_at": null,
  "failed_at": null,
  "failure_reason": null
}

O formato é o mesmo da resposta de envio. O exemplo representa uma entrega simulada concluída, com o código ainda pendente de verificação.

status: read não autentica a pessoa. Para isso, chame verificar código e confira valid.

Como acompanhar#

Se precisar atualizar a interface, consulte com um intervalo moderado e encerre a consulta quando houver o estado desejado, uma falha ou o fim do prazo. A API pública não define um intervalo obrigatório de polling.

Os recibos dependem do provedor. Um envio pode permanecer em sent sem receber confirmação de entrega ou leitura. Trate os timestamps como anuláveis.

Quando um código pendente atinge expires_at, a consulta retorna verification: expired. O status da entrega pode continuar sent, delivered ou read.

Erros#

Um ID inexistente ou fora da conta autenticada retorna 404 com send_not_found. Credenciais ausentes ou inválidas retornam 401.

Para diagnosticar uma mensagem que falhou, consulte failure_reason e leia falhas de entrega.