Token da API

Token da API

A API é composta por dois endpoints:
  • https://api.lemit.com.br/api/v1/consulta/pessoa/{cpf}
  • https://api.lemit.com.br/api/v1/consulta/empresa/{cnpj}

A documentação específica de cada endpoint e de como se autenticar na API está descrita nas abas correspondentes.

LIMITE DE 500 CONSULTAS POR SEGUNDO
PARA UTILIZAÇÃO EM LARGA ESCALA UTILIZAR A PLATAFORMA

A autenticação pode ser feita enviando o Token da API das seguintes formas:

1. Como um token Bearer no cabeçalho Authorization

Envie junto à sua requisição o cabeçalho Authorization com o seguinte conteúdo:

Bearer xxxxxxx

Atenção! O conteúdo do cabeçalho deve iniciar pelos caracteres Bearer (incluindo o espaço) seguido pelo seu Token da API.

2. Exemplo

Uma requisição curl utilizando o token da API:

curl 'https://api.lemit.com.br/api/v1/consulta/pessoa' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000'

Para informar o centro de custo, basta enviar o parâmetro segmento como atributo. Exemplo:

curl 'https://api.lemit.com.br/api/v1/consulta/pessoa' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000&segmento=1334'

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

Se o parâmetro segmento não for informado, o centro de custo faturado será o: Corporativo.

Códigos dos centros de custo

Código Descrição
1334 Corporativo
2587 Exemplo de segmento

Requisição

Faça uma chamada POST para o seguinte endpoint:

https://api.lemit.com.br/api/v1/consulta/pessoa

Também é possível fazer uma chamada GET, informando o documento na própria URL:

https://api.lemit.com.br/api/v1/consulta/pessoa/{documento}

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

O atributo {documento} deve ser uma sequência númerica representando um CPF válido.

Exemplo de requisição

curl 'https://api.lemit.com.br/api/v1/consulta/pessoa' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000'

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

Resposta

Caso o CPF consultado seja encontrado em nossas bases de dados, será retornado um documento no formato application/json com código de status 200.

Caso haja algum erro, será retornada uma mensagem com código de status ≥ 400. A API está limitada a 500 requisições por segundo a partir de um mesmo IP de origem.

Retorno

Em caso de sucesso o documento JSON retornado terá a seguinte estrutura:

    {
        "data_consulta": DataHora,
        "pessoa": {
            "cpf":             string,
            "nome":            string,
            "data_nascimento": DataHora,
            "sexo":            string,
            "nome_mae":        string,
            "falecido":        boolean,
            "situacao_cpf":    string,
            "renda":           number,
            "ocupacao":        string,
            "celulares":                 [ ... ], // array de Telefone
            "fixos":                     [ ... ], // array de Telefone
            "emails":                    [ ... ], // array de Email
            "enderecos":                 [ ... ], // array de Endereco
            "vinculos":                  [ ... ]  // array de Vinculos
            "risco_credito":              Risco Credito
            "participacao_societaria":   [ ... ]  // array de Empresas
        }
    }

Os tipos escalares string (texto), number (numérico) e boolean (lógico), seguem as regras descritas em https://json.org/.

Quando um valor não estiver disponível ele será preenchido com o valor null. Se um array (coleção) não contiver nenhum item, o campo conterá um array vazio (veja exemplo ao final).

  • O valor da coluna Ranking é uma sequência numérica crescente onde o valor 1 indica o melhor telefone para cada CPF.
  • O valor da coluna Score pode ter os seguintes valores:
    • 5 Alta probabilidade do telefone pertencer ao CPF
    • 4
    • 3
    • 2
    • 1 Menor probabilidade do telefone pertencer ao CPF
  • Note que, apesar do conceito das colunas Ranking e Score serem semelhantes, os valores da coluna Ranking sempre formarão uma sequência numérica crescente a partir do melhor telefone indiferente aos valores das colunas TipoTelefone ou Score.
  • Já o valor da coluna Score pode inclusive se repetir para diferentes valores da coluna Ranking.

Os tipos não escalares estão descritos a seguir.


voltar DataHora

Representação de um valor data e hora como uma string no formato ISO 8601. Exemplo:

"2017-07-24T17:15:07-03:00"

voltar Telefone

    {
        "ddd":     number,
        "numero":  string,
        "plus":    boolean,
        "ranking": number,
        "whatsapp": boolean
    }

voltar Email

    {
        "email":            string,
        "ranking":          number,
        "possui_cookie":    boolean
    }

voltar Endereco

    {
        "endereco":             string,
        "tipo_logradouro":      string,
        "titulo_logradouro":    string,
        "logradouro":           string,
        "numero":               string,
        "complemento":          string,
        "bairro":               string,
        "cidade":               string,
        "uf":                   string,
        "cep":                  string,
        "tipo":                 string,
        "ranking":              number
    }

voltar Risco credito

    {
        "cpf_cnpj":     string,
        "score_credito":  string
    }

voltar Vinculos

    {
        "cpf_vinculo":   string,
        "nome_vinculo":  string,
        "tipo_vinculo":  string
    }

voltar Participação societária

    {
        "nome":                 string,
        "cnpj":                 string,
        "capital_social":       number,
        "participacao_socio":   number,
        "data_fundacao":        DataHora,
        "situacao_cadastral":   string
    }

Exemplo de retorno

{
    "data_consulta": "2026-11-12T00:42:15-03:00",
    "pessoa": {
        "cpf": "00011122233300",
        "nome": "JOAO SILVA",
        "data_nascimento": "1970-10-01T00:00:00-03:00",
        "sexo": "M",
        "nome_mae": "MARIA SILVA",
        "falecido": false,
        "situacao_cpf": "REGULAR",
        "renda": 788,
        "ocupacao": null,
        "celulares": [
            {
                "ddd": 11,
                "numero": "999990000",
                "plus": true,
                "ranking": 1,
                "whatsapp": true
            },
            {
                "ddd": 11,
                "numero": "900000000",
                "plus": false,
                "ranking": 2,
                "whatsapp": false
            }
        ],
        "fixos": [],
        "emails": [
            {
                "email": "joao.silva@example.com",
                "ranking": 1,
                "possui_cookie": true
            }
        ],
        "enderecos": [
            {
                "endereco": "AV PAULISTA, 1001",
                "bairro": "BELA VISTA",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "01311000",
                "tipo": "comercial",
                "ranking": 1
            }
        ],
        "vinculos": [
            {
                "cpf_vinculo": "88877766655",
                "nome_vinculo": "JESSICA SILVA",
                "tipo_vinculo": "MAE"
            },
            {
                "cpf_vinculo": "99988877766",
                "nome_vinculo": "MARIA SILVA",
                "tipo_vinculo": "AVO"
            }
        ],
        "risco_credito": {
            "cpf_cnpj": "00011122233300",
            "score_credito": "BAIXISSIMO RISCO"
        },
        "participacao_societaria": [
            {
                nome: "EMPRESA A LTDA",
                cnpj: "00999999000199",
                capital_social: 10000,
                participacao_socio: 50,
                data_fundacao: "1998-08-04T00:00:00-03:00",
                situacao_cadastral: "INAPTA",
            },
            {
                nome: "EMPRESA B LTDA",
                cnpj: "00999999000299",
                capital_social: 50000,
                participacao_socio: 95,
                data_fundacao: "1998-01-28T00:00:00-02:00",
                situacao_cadastral: "APTA",
            },
        ],
    }
}

Requisição

Faça uma chamada POST para o seguinte endpoint:

https://api.lemit.com.br/api/v1/consulta/empresa

Também é possível fazer uma chamada GET, informando o documento na própria URL:

https://api.lemit.com.br/api/v1/consulta/empresa/{documento}

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

O atributo {documento} deve ser uma sequência númerica representando um CNPJ válido.

Exemplo de requisição

curl 'https://api.lemit.com.br/api/v1/consulta/empresa' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000'

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

Resposta

Caso o CNPJ consultado seja encontrado em nossas bases de dados, será retornado um documento no formato application/json com código de status 200.

Caso haja algum erro, será retornada uma mensagem com código de status ≥ 400. A API está limitada a 500 requisições por segundo a partir de um mesmo IP de origem.

Retorno

Em caso de sucesso o documento JSON retornado terá a seguinte estrutura:

    {
        "data_consulta": DataHora,
        "empresa": {
            "cnpj":          string,
            "razao_social":  string,
            "data_fundacao": DataHora,
            "nome_fantasia": string,
            "tipo":          string,
            "situacao":      string,
            "cnae" :         CNAE,
            "endereco" :     Endereco,
            "celulares":     [ ... ], // array de Telefone
            "fixos":         [ ... ], // array de Telefone
            "emails":        [ ... ], // array de Email
            "socios":        [ ... ]  // array de Socio
        }
    }

Os tipos escalares string (texto), number (numérico) e boolean (lógico), seguem as regras descritas em https://json.org/.

Quando um valor não estiver disponível ele será preenchido com o valor null. Se um array (coleção) não contiver nenhum item, o campo conterá um array vazio (veja exemplo ao final).

Os tipos não escalares estão descritos a seguir.


voltar DataHora

Representação de um valor data e hora como uma string no formato ISO 8601. Exemplo:

"2017-07-24T17:15:07-03:00"

voltar CNAE

    {
        "numero":    string,
        "tipo":      string,
        "segmento":  string,
        "descricao": string
    }

voltar Endereco

    {
        "endereco":             string,
        "tipo_logradouro":      string,
        "titulo_logradouro":    string,
        "logradouro":           string,
        "numero":               string,
        "complemento":          string,
        "bairro":               string,
        "cidade":               string,
        "uf":                   string,
        "cep":                  string,
        "tipo":                 string,
        "ranking":              number
    }

voltar Telefone

    {
        "ddd":     number,
        "numero":  string,
        "plus":    boolean,
        "ranking": number,
        "whatsapp": boolean
    }

voltar Email

    {
        "email":            string,
        "ranking":          number,
        "possui_cookie":    boolean
    }

voltar Sócio

    {
        "cpf":            string,
        "nome":           string,
        "participacao":   number,
        "capital_social": number
    }

Exemplo de retorno

{
    "data_consulta": "2026-11-12T00:42:15-03:00",
    "empresa": {
        "cnpj": "00111222000100",
        "razao_social": "EMPRESA EXEMPLO LTDA ME",
        "data_fundacao": "2001-02-03T00:00:00-03:00",
        "nome_fantasia": "EMPRESA EXEMPLO",
        "tipo": "ME",
        "situacao": "ATIVA",
        "cnae": {
            "numero": "00001",
            "tipo": "SERVICO",
            "segmento": "00000101",
            "descricao": "SERVICOS DE EXEMPLOS DE EMPRESAS"
        },
        "endereco": {
            "endereco": "AV PAULISTA, 1001",
            "bairro": "BELA VISTA",
            "cidade": "SAO PAULO",
            "uf": "SP",
            "cep": "01311000",
            "tipo": "comercial",
            "ranking": 1
        },
        "celulares": [
            {
                "ddd": 11,
                "numero": "999990000",
                "plus": true,
                "ranking": 1
            },
            {
                "ddd": 11,
                "numero": "900000000",
                "plus": false,
                "ranking": 2
            }
        ],
        "fixos": [],
        "emails": [
            {
                "email": "joao.silva@example.com",
                "ranking": 1
            }
        ],
        "socios": [
            {
                "cpf": "00011122233300",
                "nome": "JOAO SILVA",
                "participacao": 100,
                "capital_social": 1000
            }
        ]
    }
}

Requisição

Faça uma chamada POST para o seguinte endpoint:

https://api.lemit.com.br/api/v1/consulta/pessoa/simples

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

O atributo {documento} deve ser uma sequência númerica representando um CPF válido.

Exemplo de requisição

curl 'https://api.lemit.com.br/api/v1/consulta/pessoa/simples' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000'

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

Resposta

Caso o CPF consultado seja encontrado em nossas bases de dados, será retornado um documento no formato application/json com código de status 200.

Caso haja algum erro, será retornada uma mensagem com código de status ≥ 400. A API está limitada a 500 requisições por segundo a partir de um mesmo IP de origem.

Retorno

Em caso de sucesso o documento JSON retornado terá a seguinte estrutura:

    {
        "data_consulta": DataHora,
        "pessoa": {
            "cpf":             string,
            "nome":            string,
            "data_nascimento": DataHora,
            "sexo":            string,
            "nome_mae":        string,
            "falecido":        boolean,
            "situacao_cpf":    string,
            "renda":           number,
            "ocupacao":        string,
            "celulares":                 [ ... ], // array de Telefone
            "fixos":                     [ ... ], // array de Telefone
            "emails":                    [ ... ], // array de Email
            "enderecos":                 [ ... ], // array de Endereco
            "participacao_societaria":   [ ... ]  // array de Empresas
        }
    }

Os tipos escalares string (texto), number (numérico) e boolean (lógico), seguem as regras descritas em https://json.org/.

Quando um valor não estiver disponível ele será preenchido com o valor null. Se um array (coleção) não contiver nenhum item, o campo conterá um array vazio (veja exemplo ao final).

  • O valor da coluna Ranking é uma sequência numérica crescente onde o valor 1 indica o melhor telefone para cada CPF.

Os tipos não escalares estão descritos a seguir.


voltar DataHora

Representação de um valor data e hora como uma string no formato ISO 8601. Exemplo:

"2017-07-24T17:15:07-03:00"

voltar Telefone

    {
        "ddd":     number,
        "numero":  string,
        "plus":    null,
        "ranking": number
        "whatsapp": boolean
    }

voltar Email

    {
        "email":            string,
        "ranking":          number,
        "possui_cookie":    boolean
    }

voltar Endereco

    {
        "endereco":             string,
        "tipo_logradouro":      string,
        "titulo_logradouro":    string,
        "logradouro":           string,
        "numero":               string,
        "complemento":          string,
        "bairro":               string,
        "cidade":               string,
        "uf":                   string,
        "cep":                  string,
        "tipo":                 string,
        "ranking":              number
    }

voltar Participação societária

    {
        "nome":                 string,
        "cnpj":                 string,
        "capital_social":       number,
        "participacao_socio":   number,
        "data_fundacao":        DataHora,
        "situacao_cadastral":   string
    }

Exemplo de retorno

{
    "data_consulta": "2026-11-12T00:42:15-03:00",
    "pessoa": {
        "cpf": "00011122233300",
        "nome": "JOAO SILVA",
        "data_nascimento": "1970-10-01T00:00:00-03:00",
        "sexo": "M",
        "nome_mae": "MARIA SILVA",
        "falecido": false,
        "situacao_cpf": "REGULAR",
        "renda": 788,
        "ocupacao": null,
        "celulares": [
            {
                "ddd": 11,
                "numero": "999990000",
                "plus": null,
                "ranking": 1
            },
            {
                "ddd": 11,
                "numero": "900000000",
                "plus": null,
                "ranking": 2
            }
        ],
        "fixos": [],
        "emails": [
            {
                "email": "joao.silva@example.com",
                "ranking": 1
            }
        ],
        "enderecos": [
            {
                "endereco": "AV PAULISTA, 1001",
                "bairro": "BELA VISTA",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "01311000",
                "tipo": "comercial",
                "ranking": 1
            }
        ],
        "vinculos": [
            {
                "cpf_vinculo": "88877766655",
                "nome_vinculo": "JESSICA SILVA",
                "tipo_vinculo": "MAE"
            },
            {
                "cpf_vinculo": "99988877766",
                "nome_vinculo": "MARIA SILVA",
                "tipo_vinculo": "AVO"
            }
        ],
        "risco_credito": {
            "cpf_cnpj": "00011122233300",
            "score_credito": "BAIXISSIMO RISCO"
        },
        "participacao_societaria": [
            {
                nome: "EMPRESA A LTDA",
                cnpj: "00999999000199",
                capital_social: 10000,
                participacao_socio: 50,
                data_fundacao: "1998-08-04T00:00:00-03:00",
                situacao_cadastral: "INAPTA",
            },
            {
                nome: "EMPRESA B LTDA",
                cnpj: "00999999000299",
                capital_social: 50000,
                participacao_socio: 95,
                data_fundacao: "1998-01-28T00:00:00-02:00",
                situacao_cadastral: "APTA",
            },
        ],
    }
}

Requisição

Faça uma chamada POST para o seguinte endpoint:

https://api.lemit.com.br/api/v1/consulta/empresa/simples

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

O atributo {documento} deve ser uma sequência númerica representando um CNPJ válido.

Exemplo de requisição

curl 'https://api.lemit.com.br/api/v1/consulta/empresa/simples' \
-XPOST \
-H 'Authorization: Bearer xxxxxxx' \
--data 'documento=00000000000'

Atenção! Você deve utilizar um dos métodos de autenticação descritos na aba Autenticação.

Resposta

Caso o CNPJ consultado seja encontrado em nossas bases de dados, será retornado um documento no formato application/json com código de status 200.

Caso haja algum erro, será retornada uma mensagem com código de status ≥ 400. A API está limitada a 500 requisições por segundo a partir de um mesmo IP de origem.

Retorno

Em caso de sucesso o documento JSON retornado terá a seguinte estrutura:

    {
        "data_consulta": DataHora,
        "empresa": {
            "cnpj":          string,
            "razao_social":  string,
            "data_fundacao": DataHora,
            "nome_fantasia": string,
            "tipo":          string,
            "situacao":      string,
            "cnae" :         CNAE,
            "endereco" :     Endereco,
            "celulares":     [ ... ], // array de Telefone
            "fixos":         [ ... ], // array de Telefone
            "emails":        [ ... ], // array de Email
            "socios":        [ ... ]  // array de Socio
        }
    }

Os tipos escalares string (texto), number (numérico) e boolean (lógico), seguem as regras descritas em https://json.org/.

Quando um valor não estiver disponível ele será preenchido com o valor null. Se um array (coleção) não contiver nenhum item, o campo conterá um array vazio (veja exemplo ao final).

Os tipos não escalares estão descritos a seguir.


voltar DataHora

Representação de um valor data e hora como uma string no formato ISO 8601. Exemplo:

"2017-07-24T17:15:07-03:00"

voltar CNAE

    {
        "numero":    string,
        "tipo":      string,
        "segmento":  string,
        "descricao": string
    }

voltar Endereco

    {
        "endereco":             string,
        "tipo_logradouro":      string,
        "titulo_logradouro":    string,
        "logradouro":           string,
        "numero":               string,
        "complemento":          string,
        "bairro":               string,
        "cidade":               string,
        "uf":                   string,
        "cep":                  string,
        "tipo":                 string,
        "ranking":              number
    }

voltar Telefone

    {
        "ddd":     number,
        "numero":  string,
        "plus":    boolean,
        "ranking": number,
        "whatsapp": boolean
    }

voltar Email

    {
        "email":            string,
        "ranking":          number,
        "possui_cookie":    boolean
    }

voltar Sócio

    {
        "cpf":            string,
        "nome":           string,
        "participacao":   number,
        "capital_social": number
    }

Exemplo de retorno

{
    "data_consulta": "2026-11-12T00:42:15-03:00",
    "empresa": {
        "cnpj": "00111222000100",
        "razao_social": "EMPRESA EXEMPLO LTDA ME",
        "data_fundacao": "2001-02-03T00:00:00-03:00",
        "nome_fantasia": "EMPRESA EXEMPLO",
        "tipo": "ME",
        "situacao": "ATIVA",
        "cnae": {
            "numero": "00001",
            "tipo": "SERVICO",
            "segmento": "00000101",
            "descricao": "SERVICOS DE EXEMPLOS DE EMPRESAS"
        },
        "endereco": {
            "endereco": "AV PAULISTA, 1001",
            "bairro": "BELA VISTA",
            "cidade": "SAO PAULO",
            "uf": "SP",
            "cep": "01311000",
            "tipo": "comercial",
            "ranking": 1
        },
        "celulares": [
            {
                "ddd": 11,
                "numero": "999990000",
                "plus": null,
                "ranking": 1
            },
            {
                "ddd": 11,
                "numero": "900000000",
                "plus": null,
                "ranking": 2
            }
        ],
        "fixos": [],
        "emails": [
            {
                "email": "joao.silva@example.com",
                "ranking": 1
            }
        ],
        "socios": [
            {
                "cpf": "00011122233300",
                "nome": "JOAO SILVA",
                "participacao": 100,
                "capital_social": 1000
            }
        ]
    }
}

Para consultar o saldo e o consumo acesse o endpoint:

curl 'https://api.lemit.com.br/api/v1/saldo' \
-XPOST \
-H 'Authorization: Bearer '

×

Notificações