API Reference5. Cadastral Pessoa Jurídica5.1 Consulta e Enriquecimento PJ

PJ Telefone

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. <Note> 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. </Note> ## 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 <AccordionGroup> <Accordion title="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 | </Accordion> <Accordion title="📞 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 | </Accordion> </AccordionGroup>

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.

Errors

400
Bad Request Error
401
Unauthorized Error