iopoint
Referência

Empresa

Dados cadastrais da empresa autenticada.

URL Base
https://api.iopoint.com.br/api

Endpoints

Obter dados da empresa

GET/customer/v2/company

Retorna os dados cadastrais da empresa associada ao token: razão social, nome fantasia, endereço, contatos e identificadores fiscais (CNPJ, CEI, CAEPF, CNO).

Grupos econômicos: company_national_registry (CNPJ) retorna os dados de uma filial específica como objeto único; include_branches=1 retorna a matriz e as filiais como lista (data vira array).

Query parameters

NomeTipoObrig.Descrição
include_branchesbooleannãoQuando `1`, agrega a matriz e todas as filiais do grupo econômico na resposta. Só leitura.
company_national_registrystringnãoCNPJ (apenas dígitos) de uma empresa do grupo para restringir o escopo a ela. Use os CNPJs retornados em `GET /economic-group`. Fora do grupo acessível retorna `company_not_found` (404).

Exemplos

Request
curl -X GET "https://api.iopoint.com.br/api/customer/v2/company" \
  -H "apiIopointToken: SEU_TOKEN_AQUI"
Response200
{
  "data": {
    "name": "Empresa Exemplo LTDA",
    "trading_name": "Exemplo",
    "national_registry": "12345678000199",
    "cei": null,
    "caepf": null,
    "cno": null,
    "address": "Av. Paulista",
    "address_number": "1000",
    "complement": "Sala 101",
    "neighborhood": "Bela Vista",
    "zip_code": "01310100",
    "phone": "1140040000",
    "email": "[email protected]"
  }
}

Respostas

200
{
  "data": {
    "name": "Empresa Exemplo LTDA",
    "trading_name": "Exemplo",
    "national_registry": "12345678000199",
    "cei": null,
    "caepf": null,
    "cno": null,
    "address": "Av. Paulista",
    "address_number": "1000",
    "complement": "Sala 101",
    "neighborhood": "Bela Vista",
    "zip_code": "01310100",
    "phone": "1140040000",
    "email": "[email protected]"
  }
}