## Junta Comercial / SP / NIRE (Pesquisa Avançada)
Consulta o Número de identificação do Registro de Empresas (NIRE) na Junta Comercial do Estado de São Paulo (JUCESP) a partir de filtros da empresa, como razão social, endereço, objeto ou tipo de empresa. A API retornará até 15 resultados da pesquisa.


### Site URL
- https://jucesponline.sp.gov.br/BuscaAvancada.aspx?IDProduto=

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/junta-comercial/sp/nire`



| Parameter           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token*              | The token that will authenticate and authorize the request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| razao_social**      | Razão social da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| objeto**            | Conteúdo presente no objeto da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| capital_minimo**    | Valor mínimo do capital social. Para o valor de R$ 1.200,35, o valor que deve ser informado é "1200.35"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| capital_maximo**    | Valor máximo do capital social. Para o valor de R$ 1.200,35, o valor que deve ser informado é "1200.35"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| abertura_inicio**   | Data anterior à abertura da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| abertura_fim**      | Data posterior à abertura da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| dissolucao_inicio** | Data anterior à dissolução da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dissolucao_fim**    | Data posterior à dissolução da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| logradouro**        | Logradouro da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| cep**               | CEP da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| bairro**            | Bairro da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| municipio**         | Município da empresa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| uf**                | UF da empresa. Por exemplo, para o estado de São Paulo, o valor que deve ser informado é <strong>SP</strong>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| tipo_empresa**      | Tipo da empresa. Possíveis valores: <br><ul><li><strong>1</strong> para Empresário</li><li><strong>2</strong> para Sociedade Limitada</li><li><strong>3</strong> para Sociedade por Ações</li><li><strong>4</strong> para Cooperativa</li><li><strong>5</strong> para Consórcio</li><li><strong>6</strong> para Grupo</li><li><strong>7</strong> para Comandita Simples</li><li><strong>8</strong> para Comandita por Ações</li><li><strong>9</strong> para Capital Indústria</li><li><strong>10</strong> para Solidária</li><li><strong>11</strong> para Armazéns Gerais Ltda</li><li><strong>12</strong> para Empresa Estrangeira</li><li><strong>13</strong> para Binacional Ltda</li><li><strong>14</strong> para Sociedade em Nome Coletivo</li><li><strong>15</strong> para Empresa Pública</li><li><strong>16</strong> para Subsidiária Integral</li><li><strong>17</strong> para Sociedade em Conta de Participação</li><li><strong>18</strong> para Armazéns Gerais S/A</li><li><strong>19</strong> para Binacional S/A</li><li><strong>20</strong> para Armazéns Gerais Empresário</li><li><strong>21</strong> para EIRELI</li><li><strong>9999</strong> para Outros</li></ul> |
| inclui_inativas**   | Se a pesquisa deve incluir empresas inativas, este campo deve ter o valor <strong>1</strong> informado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

> * Required parameter.

> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.


### Response examples (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "service": "junta-comercial/sp/nire",
    "parameters": {
      "name": "Nome de Exemplo",
      "cpf": "11111111111",
      "senha": "3$Nfp10os92pr"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.2",
    "requested_at": "2020-01-03T15:45:07.000-03:00",
    "elapsed_time_in_milliseconds": 3191,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX1+BkeRLRCkXeYvSai6jsOzsmabEDoO1JmJNAO58y+RCdaO/SqzVNg4g4uy7gdUBFGN8xooyPlv7ag=="
  },
  "data_count": 1,
  "data": [
    {
      "municipio": "São Paulo",
      "nire": "11111111111",
      "nome": "Nome de Exemplo",
      "site_receipt": "https://api.infosimples.com/exemplo-de-url"
    }
  ],
  "site_receipts": [
    "https://api.infosimples.com/exemplo-de-url"
  ]
}
```


### Preview file

The preview file (`site_receipts`) in the response JSON is **generated by the source (website/app)** that processed the automation.

### Code snippets


#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/junta-comercial/sp/nire'
args = {
  "razao_social":      "VALUE_OF_PARAMETER_RAZAO_SOCIAL",
  "objeto":            "VALUE_OF_PARAMETER_OBJETO",
  "capital_minimo":    "VALUE_OF_PARAMETER_CAPITAL_MINIMO",
  "capital_maximo":    "VALUE_OF_PARAMETER_CAPITAL_MAXIMO",
  "abertura_inicio":   "VALUE_OF_PARAMETER_ABERTURA_INICIO",
  "abertura_fim":      "VALUE_OF_PARAMETER_ABERTURA_FIM",
  "dissolucao_inicio": "VALUE_OF_PARAMETER_DISSOLUCAO_INICIO",
  "dissolucao_fim":    "VALUE_OF_PARAMETER_DISSOLUCAO_FIM",
  "logradouro":        "VALUE_OF_PARAMETER_LOGRADOURO",
  "cep":               "VALUE_OF_PARAMETER_CEP",
  "bairro":            "VALUE_OF_PARAMETER_BAIRRO",
  "municipio":         "VALUE_OF_PARAMETER_MUNICIPIO",
  "uf":                "VALUE_OF_PARAMETER_UF",
  "tipo_empresa":      "VALUE_OF_PARAMETER_TIPO_EMPRESA",
  "inclui_inativas":   "VALUE_OF_PARAMETER_INCLUI_INATIVAS",
  "token":             "WRITE_YOUR_TOKEN_HERE",
  "timeout":           "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.