PJ Telefone | Credify API

curl -X POST https://api.credify.com.br/pjtelefone \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "Consulta": {
    "IdConsulta": "8",
    "Ddd": "",
    "Telefone": "",
    "TipoPessoa": "J"
  }
}'

{
  "CONSULTA": {
    "CODIGORESPOSTA": "11111111",
    "DATAHORA": "02/08/2024 20:56:38",
    "LOGON": "11111",
    "IDCONSULTA": "8"
  },
  "RESPOSTA": {
    "CODIGO": "1",
    "BUSCATELEFONE": {
      "REGISTRO_1": {
        "BAIRRO": "BAIRRO ANONIMIZADO 1",
        "CEP": "00000000",
        "CIDADE": "SAO PAULO",
        "CNPJ": "00000000000000",
        "COMPLEMENTO": "COMPLEMENTO ANONIMIZADO 1",
        "ENDERECO": "ENDERECO ANONIMIZADO 1",
        "LOGRADOURO": "LOGRADOURO ANONIMIZADO 1",
        "NUMERO": "000",
        "RAZAO": "EMPRESA ANONIMIZADA 1",
        "TP": "0",
        "TPLOGRADOURO": [],
        "UF": "SP"
      },
      "REGISTRO_2": {
        "BAIRRO": "BAIRRO ANONIMIZADO 2",
        "CEP": "00000000",
        "CIDADE": "SAO PAULO",
        "CNPJ": "00000000000000",
        "COMPLEMENTO": "COMPLEMENTO ANONIMIZADO 2",
        "ENDERECO": "ENDERECO ANONIMIZADO 2",
        "LOGRADOURO": "LOGRADOURO ANONIMIZADO 2",
        "NUMERO": "000",
        "RAZAO": "EMPRESA ANONIMIZADA 2",
        "TP": "0",
        "TPLOGRADOURO": [],
        "UF": "SP"
      },
      "REGISTRO_3": {
        "BAIRRO": "BAIRRO ANONIMIZADO 3",
        "CEP": "00000000",
        "CIDADE": "SAO PAULO",
        "CNPJ": "00000000000000",
        "COMPLEMENTO": "COMPLEMENTO ANONIMIZADO 3",
        "ENDERECO": "ENDERECO ANONIMIZADO 3",
        "LOGRADOURO": "LOGRADOURO ANONIMIZADO 3",
        "NUMERO": "000",
        "RAZAO": "EMPRESA ANONIMIZADA 3",
        "TP": "0",
        "TPLOGRADOURO": [],
        "UF": "SP"
      }
    }
  }
}

Esta API realiza a busca de pessoas jurídicas a partir de um número de telefone. A resposta fornece uma lista de registros que contêm informações da empresa associada ao telefone consultado, incluindo CNPJ, razão social, endereço completo (logradouro, número, complemento, bairro, cidade, UF, CEP) e tipo de contato. É utilizada para fins de verificação, enriquecimento de dados e validação de empresas com base em informações de telefone.

Indicada para enriquecimento de dados, verificação de vínculo empresa-telefone e prevenção a fraudes em processos de onboarding e validação cadastral de PJ.

TABELA DE CAMPOS DE REQUISIÇÃO

Campo	Descrição	Formato	Obrigatório
IdConsulta	Identificador da consulta. Valor fixo: `8`.	string	Sim
Ddd	DDD do telefone a ser consultado.	string	Sim
Telefone	Número do telefone a ser consultado.	string	Sim
TipoPessoa	Tipo de pessoa consultada. Valor fixo: `J`.	string	Sim

TABELA DE CAMPOS DE RETORNO

Cabeçalho da Resposta — CONSULTA

Campo	Descrição	Formato
CONSULTA.CODIGORESPOSTA	Código interno da transação.	string
CONSULTA.DATAHORA	Data e hora da consulta.	`DD/MM/YYYY HH:MM:SS`
CONSULTA.LOGON	Identificador da conta que realizou a consulta.	string
CONSULTA.IDCONSULTA	IdConsulta enviado na requisição.	string

📞 Empresas Vinculadas ao Telefone — BUSCATELEFONE

Campo	Descrição	Formato
RESPOSTA.CODIGO	Código do resultado: `1` sucesso · `2` não encontrado · `3` erro.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.CNPJ	CNPJ da empresa vinculada ao telefone.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.RAZAO	Razão social da empresa.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.TPLOGRADOURO	Tipo de logradouro.	array
RESPOSTA.BUSCATELEFONE.REGISTRO_N.LOGRADOURO	Nome do logradouro.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.NUMERO	Número do endereço.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.ENDERECO	Endereço completo formatado.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.COMPLEMENTO	Complemento do endereço.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.BAIRRO	Bairro.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.CEP	CEP do endereço.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.CIDADE	Cidade.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.UF	Unidade Federativa.	string
RESPOSTA.BUSCATELEFONE.REGISTRO_N.TP	Tipo de contato telefônico.	string

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Objeto de consulta com o DDD e número de telefone da empresa.

ConsultaobjectRequired

Response

Resposta da consulta:

Código 1: Sucesso.
Código 2: Dado não encontrado na base de dados.
Código 3: Erro na consulta.

CONSULTAobjectOptional

RESPOSTAobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error