Consultar Status da Autorização

Consulta o status atual da autorização Dataprev de um trabalhador. Utilize este endpoint para verificar se a autorização foi concluída antes de prosseguir para a consulta de margem.

Fluxo recomendado

Após enviar a autorização, faça polling neste endpoint até que o status indique que a autorização foi concluída. Recomendamos intervalos de 10 a 30 segundos entre as consultas.

Parâmetros

Parâmetro	Local	Tipo	Descrição
cpf	path	string	CPF do employee (11 dígitos, sem pontuação)

Próximo passo

Quando a autorização estiver concluída, prossiga para Consultar Margem.

Status de Autorização

get

https://consignado.staging.giro.techhttps://consignado.giro.tech

/api/v1/originator/employees/{cpf}/authorization/status

Consulta status de autorização Dataprev de um employee

Autorizações

BearerAuth

AuthorizationstringObrigatório

JWT token fornecido pelo administrador

Parâmetros de rota

cpfstringObrigatório

CPF do employee (11 dígitos)

Pattern: ^\d{11}$

Respostas

200

Status retornado com sucesso

application/json

statusstring · enumOpcional

Status da autorização Dataprev.

Valor	Significado
NOT_STARTED	Processo não iniciado
PENDING_SIGNATURE	Aguardando assinatura do termo
PENDING_SUBMISSION	Aguardando envio ao Dataprev
AUTHORIZED	Autorização concluída (termo assinado)
EXPIRED	Prazo de assinatura expirado

Valores possíveis:

messagestringOpcional

signUrlstringOpcional

nsustringOpcional

expiresAtstring · date-timeOpcional

daysRemainingintegerOpcional

401

Não autenticado

403

Permissão insuficiente

404

Employee não encontrado

get

/api/v1/originator/employees/{cpf}/authorization/status

HTTPcURLJavaScriptPython

GET /api/v1/originator/employees/{cpf}/authorization/status HTTP/1.1
Host: consignado.staging.giro.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "PENDING_SIGNATURE",
  "message": "Aguardando assinatura do trabalhador.",
  "signUrl": "https://sign.example.com/auth/abc123",
  "nsu": "20250115000001",
  "expiresAt": "2025-01-22T23:59:59Z",
  "daysRemaining": 7
}

Central de Atendimento | Giro.TechGiro.Tech