IZConnect API

Concentrador de APIs de dados cadastrais. Consulte informacoes de CPF, CNPJ e outros registros de forma rapida, com cache inteligente e uma unica integracao.

Online REST API Cache Automatico API Key Auth JSON

URL Base

Todas as requisicoes devem ser feitas para o seguinte endereco:

Base URL https://izconnect.iztec.online

Autenticacao

Cada empresa recebe um token unico ao ser cadastrada no IZConnect. Este token deve ser enviado em todas as requisicoes aos endpoints protegidos.

Como enviar o token

Header X-API-Key: iz_seu_token_aqui
Query ?api_key=iz_seu_token_aqui
O token da sua empresa e gerado pelo administrador do IZConnect. Cada empresa tem seu proprio token, que pode ser regenerado a qualquer momento pelo painel admin.

Formato de Resposta

Todas as respostas sao retornadas em formato JSON com a seguinte estrutura padrao:

JSON - Resposta de Sucesso 
{
    "success": true,
    "message": "Descricao da operacao",
    "data": { // dados retornados }
}
JSON - Resposta de Erro 
{
    "success": false,
    "error": "Descricao do erro"
}

Codigos de Status HTTP

Health Check

GET /health Publico

Verifica se o servico esta online e o status da conexao com o banco de dados. Util para monitoramento e health checks automatizados.

Exemplo de Requisicao
cURL 
curl -s https://izconnect.iztec.online/health
Resposta
200 OK 
{
    "success": true,
    "message": "IZConnect esta operacional",
    "data": {
        "service": "IZConnect",
        "version": "1.0.0",
        "php": "8.3.30",
        "database": "connected",
        "timestamp": "2026-03-14 17:00:00"
    }
}

Listar APIs Disponiveis

GET /apis Publico

Lista todos os endpoints disponiveis no concentrador com seus parametros e metodos de autenticacao.

cURL 
curl -s https://izconnect.iztec.online/apis
200 OK 
{
    "success": true,
    "message": "APIs disponiveis",
    "data": {
        "endpoints": [
            {
                "method": "GET",
                "path": "/api/cpf",
                "description": "Consulta dados basicos de pessoa fisica por CPF",
                "params": { "cpf": "string (11 digitos)" },
                "auth": "X-API-Key header ou ?api_key= query param"
            }
        ]
    }
}

Consulta CPF

Retorna dados basicos de pessoa fisica a partir do numero de CPF. O sistema utiliza cache inteligente: se o CPF ja foi consultado anteriormente, retorna do banco local (mais rapido e sem custo). Caso contrario, consulta a API externa, salva no cache e retorna.

Cache Inteligente: Consultas repetidas sao retornadas do cache local, reduzindo custos e tempo de resposta. O campo source na resposta indica se veio do cache ou da api externa.
GET /api/cpf API Key

Consulta dados de CPF via query parameter.

Parametros (Query String)
Parametro Tipo Obrigatorio Descricao
cpf string Sim Numero do CPF com 11 digitos (somente numeros ou com mascara)
Exemplos de Requisicao
cURL - Header Auth 
curl -s \
  -H 'X-API-Key: iz_SEU_TOKEN' \
  'https://izconnect.iztec.online/api/cpf?cpf=12345678901'
cURL - Query Auth 
curl -s 'https://izconnect.iztec.online/api/cpf?cpf=12345678901&api_key=iz_SEU_TOKEN'
JavaScript (fetch) 
fetch('https://izconnect.iztec.online/api/cpf?cpf=12345678901', {
  headers: { 'X-API-Key': 'iz_SEU_TOKEN' }
})
.then(r => r.json())
.then(console.log);
Python (requests) 
import requests

response = requests.get(
    'https://izconnect.iztec.online/api/cpf',
    params={'cpf': '12345678901'},
    headers={'X-API-Key': 'iz_SEU_TOKEN'}
)
print(response.json())
PHP (cURL) 
$ch = curl_init('https://izconnect.iztec.online/api/cpf?cpf=12345678901');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: iz_SEU_TOKEN'],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
Respostas
200 OK 
{
    "success": true,
    "message": "Consulta realizada com sucesso",
    "data": {
        "id": 1,
        "cpf": "12345678901",
        "nome": "JOAO DA SILVA SANTOS",
        "data_nascimento": "15/03/1990",
        "sexo": "M",
        "nome_mae": "MARIA DA SILVA",
        "nome_pai": "JOSE DOS SANTOS",
        "situacao": "Regular",
        "pis": "12345678901",
        "ctps": "",
        "titulo": "0012345678901",
        "rg_numero": "12.345.678-9",
        "rg_emissor": "SSP",
        "rg_uf": "SP",
        "produto": "pf-dadosbasicos",
        "data_agora": "2026-03-14 17:00:00"
    }
}
401 Unauthorized 
{
    "success": false,
    "error": "Token invalido ou empresa inativa"
}
422 Unprocessable Entity 
{
    "success": false,
    "error": "Parametro \"cpf\" e obrigatorio"
}
Campos Retornados
Campo Tipo Descricao
cpf string Numero do CPF (11 digitos)
nome string Nome completo do titular
data_nascimento string Data de nascimento (DD/MM/AAAA)
sexo string Sexo (M ou F)
nome_mae string Nome da mae
nome_pai string Nome do pai
situacao string Situacao cadastral na Receita Federal
pis string Numero do PIS/PASEP
ctps string Numero da CTPS
titulo string Numero do titulo de eleitor
rg_numero string Numero do RG
rg_emissor string Orgao emissor do RG
rg_uf string UF de emissao do RG

Consulta CPF (POST)

POST /api/cpf API Key

Mesma consulta de CPF, porem recebendo o parametro via corpo da requisicao em JSON. Ideal para integracoes que preferem enviar dados via body.

Parametros (Body JSON)
Parametro Tipo Obrigatorio Descricao
cpf string Sim Numero do CPF com 11 digitos
Exemplos de Requisicao
cURL 
curl -s -X POST 'https://izconnect.iztec.online/api/cpf' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: iz_SEU_TOKEN' \
  -d '{"cpf": "12345678901"}'
JavaScript (fetch) 
fetch('https://izconnect.iztec.online/api/cpf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'iz_SEU_TOKEN'
  },
  body: JSON.stringify({ cpf: '12345678901' })
})
.then(r => r.json())
.then(console.log);
Python (requests) 
import requests

response = requests.post(
    'https://izconnect.iztec.online/api/cpf',
    json={'cpf': '12345678901'},
    headers={'X-API-Key': 'iz_SEU_TOKEN'}
)
print(response.json())
A resposta deste endpoint e identica a versao GET. Consulte a secao Consulta CPF (GET) para ver todos os campos retornados.

Consulta CNPJ

Retorna dados cadastrais de pessoa juridica a partir do numero de CNPJ. Inclui informacoes de situacao cadastral, endereco, atividade economica (CNAE), porte, capital social e MCC (quando disponivel). O sistema utiliza cache inteligente.

Cache Inteligente: CNPJs ja consultados sao retornados do cache local. O campo source na resposta indica se veio do cache ou da api externa.
GET /api/cnpj API Key

Consulta dados de CNPJ via query parameter.

Parametros (Query String)
Parametro Tipo Obrigatorio Descricao
cnpj string Sim Numero do CNPJ com 14 digitos (somente numeros ou com mascara)
Exemplos de Requisicao
cURL 
curl -s \
  -H 'X-API-Key: iz_SEU_TOKEN' \
  'https://izconnect.iztec.online/api/cnpj?cnpj=12345678000190'
JavaScript (fetch) 
fetch('https://izconnect.iztec.online/api/cnpj?cnpj=12345678000190', {
  headers: { 'X-API-Key': 'iz_SEU_TOKEN' }
})
.then(r => r.json())
.then(console.log);
Python (requests) 
import requests

response = requests.get(
    'https://izconnect.iztec.online/api/cnpj',
    params={'cnpj': '12345678000190'},
    headers={'X-API-Key': 'iz_SEU_TOKEN'}
)
print(response.json())
PHP (cURL) 
$ch = curl_init('https://izconnect.iztec.online/api/cnpj?cnpj=12345678000190');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: iz_SEU_TOKEN'],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
Respostas
200 OK 
{
    "success": true,
    "message": "Consulta realizada com sucesso",
    "data": {
        "cnpj": "12345678000190",
        "nome": "EMPRESA EXEMPLO LTDA",
        "fantasia": "EXEMPLO",
        "abertura": "01/01/2010",
        "situacao": "ATIVA",
        "tipo": "MATRIZ",
        "porte": "MICRO EMPRESA",
        "natureza_juridica": "206-2 - Sociedade Empresaria Limitada",
        "cnae_codigo": "62.01-5-01",
        "cnae_descricao": "Desenvolvimento de programas de computador sob encomenda",
        "logradouro": "RUA EXEMPLO",
        "numero": "123",
        "complemento": "SALA 1",
        "bairro": "CENTRO",
        "municipio": "SAO PAULO",
        "uf": "SP",
        "cep": "01000-000",
        "email": "contato@exemplo.com.br",
        "telefone": "(11) 1234-5678",
        "capital_social": "100000.00",
        "mcc": 5734
    }
}
401 Unauthorized 
{
    "success": false,
    "error": "Token invalido ou empresa inativa"
}
422 Unprocessable Entity 
{
    "success": false,
    "error": "Parametro \"cnpj\" e obrigatorio"
}
Campos Retornados
Campo Tipo Descricao
cnpjstringNumero do CNPJ (14 digitos)
nomestringRazao social
fantasiastringNome fantasia
aberturastringData de abertura
situacaostringSituacao cadastral (ATIVA, BAIXADA, etc)
data_situacaostringData da situacao cadastral
tipostringTipo (MATRIZ ou FILIAL)
portestringPorte da empresa
natureza_juridicastringNatureza juridica
cnae_codigostringCodigo CNAE da atividade principal
cnae_descricaostringDescricao do CNAE
logradourostringLogradouro
numerostringNumero
complementostringComplemento
bairrostringBairro
municipiostringMunicipio
ufstringUF
cepstringCEP
emailstringE-mail da empresa
telefonestringTelefone
capital_socialstringCapital social
mccint|nullMCC (Merchant Category Code) baseado no CNAE, quando disponivel

Consulta CNPJ (POST)

POST /api/cnpj API Key

Mesma consulta de CNPJ, porem recebendo o parametro via corpo da requisicao em JSON.

Parametros (Body JSON)
Parametro Tipo Obrigatorio Descricao
cnpj string Sim Numero do CNPJ com 14 digitos
Exemplos de Requisicao
cURL 
curl -s -X POST 'https://izconnect.iztec.online/api/cnpj' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: iz_SEU_TOKEN' \
  -d '{"cnpj": "12345678000190"}'
JavaScript (fetch) 
fetch('https://izconnect.iztec.online/api/cnpj', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'iz_SEU_TOKEN'
  },
  body: JSON.stringify({ cnpj: '12345678000190' })
})
.then(r => r.json())
.then(console.log);
A resposta deste endpoint e identica a versao GET. Consulte a secao Consulta CNPJ (GET) para ver todos os campos retornados.

IZConnect — Concentrador de APIs — izconnect.iztec.online

Versao 1.0.0 · Atualizado em Março 2026