Consultar pedido

GET/v1/access-requests/{cnpj}

Mostra a situação do pedido de acesso da sua software house para um CNPJ. Na primeira consulta depois da aprovação, entrega o token do cliente (company_token).

Autenticação: Authorization: Bearer <access_token>.

Requisição

Parâmetro de caminho	Descrição
cnpj	CNPJ do cliente: 14 posições, numérico ou alfanumérico. Prefira sem máscara (12345678000195); com máscara, codifique a / na URL (%2F).

curl "$BASE_URL/v1/access-requests/12345678000195" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Resposta 200

Campo de data	Tipo	Quando vem	Descrição
status	string	Sempre	Situação do pedido (tabela abaixo).
requested_at	string (ISO 8601)	Quando há pedido	Quando o pedido foi feito.
revoked_at	string (ISO 8601)	Depois de revogado	Quando o acesso foi cortado.
company_token	string	Uma única vez, na primeira consulta com APPROVED	Token do cliente para o header X-Company-Token.

Status

status	Significado	O que fazer
PENDING	Pedido aguardando o cliente (até 7 dias).	Avise o cliente e consulte de novo mais tarde.
APPROVED	Cliente aprovou.	Na primeira vez, guarde o company_token. Depois, use os feeds.
DENIED	Cliente recusou.	Fale com o cliente. Um pedido novo só pode ser aberto 30 dias depois da recusa.
REVOKED	O acesso foi cortado pelo cliente ou pelo Concilia+. O company_token não vale mais.	Pare de sincronizar. Para voltar, abra um pedido novo.
EXPIRED	O cliente não respondeu em 7 dias.	Abra um pedido novo.
NOT_FOUND	Não há pedido da sua software house para esse CNPJ, o CNPJ é inválido ou a empresa foi desativada no Concilia+.	Abra um pedido com POST /v1/access-requests.

Exemplos

Aprovado, primeira consulta (com o token):

{
  "message": "Situação do pedido",
  "result": true,
  "data": {
    "status": "APPROVED",
    "requested_at": "2026-10-21T13:02:11.000Z",
    "company_token": "cpt_q1w2e3r4t5y6u7i8o9p0a1s2d3f4g5h6j7k8l9z0x1c"
  },
  "error": null
}

Aprovado, consultas seguintes (sem o token):

{
  "message": "Situação do pedido",
  "result": true,
  "data": {
    "status": "APPROVED",
    "requested_at": "2026-10-21T13:02:11.000Z"
  },
  "error": null
}

Pendente:

{
  "message": "Situação do pedido",
  "result": true,
  "data": {
    "status": "PENDING",
    "requested_at": "2026-10-21T13:02:11.000Z"
  },
  "error": null
}

Revogado:

{
  "message": "Situação do pedido",
  "result": true,
  "data": {
    "status": "REVOKED",
    "requested_at": "2026-10-21T13:02:11.000Z",
    "revoked_at": "2026-11-03T09:12:00.000Z"
  },
  "error": null
}

Sem pedido:

{
  "message": "Situação do pedido",
  "result": true,
  "data": { "status": "NOT_FOUND" },
  "error": null
}

:::danger Grave o company_token antes de qualquer outra coisa Se a sua aplicação cair entre receber a resposta e gravar o token, ele se perde: a próxima consulta já vem sem ele. Nesse caso, use a reemissão. :::

:::note PENDING não confirma que o CNPJ é cliente Para não revelar quem usa o Concilia+, um pedido para um CNPJ que não é cliente também aparece como PENDING por 7 dias e depois EXPIRED. Só um cliente de verdade chega a APPROVED ou DENIED. :::

Consultando com frequência

Enquanto estiver PENDING, consultar a cada 15 minutos ou mais é suficiente. Lembre que essas consultas entram no mesmo limite por minuto dos feeds.

Erros

Código	Quando
401	Token de acesso ausente, vencido ou inválido.
429	Limite por minuto excedido.