Consultar autorização

GET/v1/margem/autorizacao

🔒 Requer Bearer token

Escopo margem:read. Retorna a autorização mais recente do CPF com seu status (pendente | autorizado | expirado | revogado), permitindo acompanhar o ciclo após a criação. autorizado_em é null enquanto não houver aceite do trabalhador. Sem nenhuma autorização para o CPF, retorna { "autorizacao": null }.

Parâmetros

cpfstringqueryobrigatório

CPF do trabalhador (11 dígitos)

padrão: ^\d{11}$

Respostas

200Autorização mais recente do CPF com seu `status` (ou `{ autorizacao: null }`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

Request

curl -X GET 'http://localhost:3101/v1/margem/autorizacao?cpf=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "autorizacao": {
    "id": "9f3a1c20-7b4e-4d2a-bf11-2e6c8a0d5e44",
    "status": "autorizado",
    "autorizado_em": "2026-06-25T14:32:07.512Z",
    "expira_em": "2026-06-27T14:32:07.000Z"
  }
}