# Consultar informações de empresas

Busca informações detalhadas de empresa por CNPJ

Endpoint: GET /companies
Version: 1.0
Security: ApiKeyAuth

## Query parameters:

  - `cnpj` (string, required)
    CNPJ da empresa (apenas números)
    Example: "12345678000199"

  - `fields` (string)
    Campos específicos a retornar (separados por vírgula)
    Example: "company_name,cnpj,emails,partners"

## Response 200 fields (application/json):

  - `cnpj` (string)
    Example: "12345678000199"

  - `company_name` (string)
    Example: "FULANO DE TAL EXEMPLO"

  - `trading_name` (string)
    Example: "EMPRESA EXEMPLO"

  - `creation_date` (string)
    Example: "2022-01-01"

  - `age` (string)
    Example: "3 anos 3 meses"

  - `business_size` (string)
    Example: "ME"

  - `city_uf` (string)
    Example: "CIDADE EXEMPLO, EX"

  - `cnae_code` (integer)
    Example: 9511800

  - `cnae_description` (string)
    Example: "Reparação e manutenção de computadores e de equipamentos periféricos"

  - `registry_situation` (string)
    Example: "ATIVA"

  - `addresses` (array)

  - `addresses.type` (string)
    Example: "Avenida"

  - `addresses.street` (string)
    Example: "Lorem Ipsum"

  - `addresses.number` (string)
    Example: "9999"

  - `addresses.complement` (string,null)

  - `addresses.neighborhood` (string)
    Example: "Bairro Exemplo"

  - `addresses.city` (string)
    Example: "Cidade Exemplo"

  - `addresses.district` (string)
    Example: "EX"

  - `addresses.postal_code` (string)
    Example: "00000000"

  - `addresses.priority` (integer)
    Example: 1

  - `branch_offices` (array)

  - `partners` (array)

  - `emails` (array)

  - `land_lines` (array)

  - `mobile_phones` (array)

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Example: "no credits"

  - `error.description` (string)
    Example: "Você não possui saldo suficiente, disponível 0"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Invalid token"