Consultar CNPJ

GEThttps://api.sandbox.cefispay.com.br/api/v1/cnpj/{cnpj}

Retorna os dados cadastrais de uma empresa pelo CNPJ, como razão social, nome fantasia e endereço, para preencher formulários de cadastro e cobrança. O CNPJ pode ser enviado com ou sem pontuação (sem a barra, que quebraria o caminho). Limite: 30 consultas por minuto por token.

Parâmetros de path

cnpjstringobrigatório
CNPJ com 14 dígitos.

Respostas

200Dados da empresa

Corpo da resposta

application/json

dataobject
data object
- taxIdstring
- aliasstringpode ser nulo
  Nome fantasia
- companyobject
  company object
  - namestring
    Razão social
- addressobject
  address object
  - streetstring
  - numberstring
  - detailsstringpode ser nulo
  - districtstring
  - citystring
  - statestring
  - zipstring

Exemplo

{
  "data": {
    "taxId": "00000000000191",
    "alias": "Banco do Brasil",
    "company": {
      "name": "BANCO DO BRASIL SA"
    },
    "address": {
      "street": "string",
      "number": "string",
      "details": "string",
      "district": "string",
      "city": "string",
      "state": "string",
      "zip": "string"
    }
  }
}

401Não autenticado

Corpo da resposta

application/json

codestring
O código do erro. Ex.: VALIDATION_ERROR, FORBIDDEN_ERROR, UNEXPECTED_ERROR.
messagestring
A mensagem do erro.
errorsobject
Os erros de cada campo, quando o code é VALIDATION_ERROR.
timestampstringdate-time
A data e hora do erro, em UTC.
request_idstring
Um identificador único gerado para esta resposta de erro.
documentation_urlstring
O endereço desta documentação.
suggestionstring
Uma sugestão de como resolver o erro.

Exemplo

{
  "code": "AUTHENTICATION_ERROR",
  "message": "Não autenticado.",
  "timestamp": "2026-10-22T12:03:44+00:00",
  "request_id": "f2a7e962-6083-4525-816e-f14d4a602e0a",
  "documentation_url": "https://docs.ninepay.com.br"
}

422CNPJ sem 14 dígitos

Corpo da resposta

application/json

messagestring

Exemplo

{
  "message": "CNPJ inválido."
}

429Limite de consultas por minuto atingido

Sem corpo de resposta.

502Não foi possível consultar o CNPJ no momento

Corpo da resposta

application/json

messagestring

Exemplo

{
  "message": "Não foi possível consultar o CNPJ."
}

Parâmetros de path

Respostas

Credenciais

Resposta