# Análise de Risco Positivo - PJ

> Verifica o CNPJ de uma pessoa jurídica e retorna indicadores de Risco Positivo (score, comportamento financeiro, restrições) para análises de crédito e onboarding.

- **Consulta:** `boa-vista-risco-pj`
- **Categoria:** Crédito & Score
- **Preço:** R$ 14,64 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/credito-e-score/boa-vista-risco-pj

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Permite validar dados cadastrais e avaliar o perfil de risco de pessoas jurídicas através de uma consulta estruturada por CNPJ. O endpoint realiza uma análise comportamental da empresa, integrando informações sobre histórico de pagamentos, compromissos comerciais, restrições financeiras, composição societária e indicadores de governança.
>
> A consulta retorna um score de risco com classificação numérica e alfabética (ABC), além de probabilidade de inadimplência, facilitando decisões sobre concessão de crédito, avaliação de fornecedores e monitoramento contínuo da saúde financeira. Os resultados incluem detalhes registrais, fiscais e comportamentais da empresa, fornecendo uma visão integrada para análise de risco de crédito.
>
> **Casos de uso:**
> - Onboarding de clientes e fornecedores
> - Análise de elegibilidade para concessão de crédito
> - Avaliação de probabilidade de inadimplência
> - Suporte a decisões comerciais baseadas em score e indicadores positivos
> - Monitoramento periódico da situação financeira e comportamental

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj?cnpj=SEU_CNPJ"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj",
    params={"cnpj": "SEU_CNPJ"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cnpj` | CNPJ | sim | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A consulta retorna um objeto estruturado contendo:
>
> **Dados cadastrais e registrais:** CNPJ, razão social, nome fantasia, natureza jurídica, inscrição estadual, NIRE, tipo de sociedade, data de fundação e data de encerramento (se aplicável).
>
> **Informações comerciais:** Ramo de atividade (primário e secundário), código CNAE, capital social, porte da empresa, faixa de funcionários, quantidade de filiais e cidades onde opera.
>
> **Endereço:** Logradouro completo, bairro, cidade, UF e CEP.
>
> **Contato:** Telefone e endereço de e-mail.
>
> **Score e indicadores de risco:** Pontuação geral, tipo de score, classificação ABC, classificação numérica, descrição do score, probabilidade de inadimplência e nível de risco associado.
>
> **Decisões registrais:** Código e descrição da situação atual, situação no cadastro de contribuinte (Sintegra) e observações.
>
> **Indicadores comportamentais:** Histórico de crédito obtido, compromissos assumidos, pagamentos pontuais, pagamentos atrasados, eventos relacionados à pessoa jurídica, período de relacionamento com fornecedores e tendências de pontuação mensal.
>
> **Restrições:** Pendências financeiras (quantidade, valores, prazos, credores e provedores), protestos, cheques sem fundo (BACEN e varejo), condenações cíveis, contumácia, falências e recuperações judiciais.
>
> **Governança:** Lista de administradores com cargo e data de entrada, lista de sócios com percentual de participação e tipo de documento.
>
> **Alertas:** Avisos relevantes sobre a empresa.
>
> **Histórico de consultas:** Registro das datas e dados retornados em buscas anteriores.

### Exemplo de resposta

```json
{
  "cnpj": "string",
  "nire": "string",
  "email": null,
  "porte": null,
  "score": {
    "risco": "string",
    "score": "string",
    "texto": "string",
    "layout": "string",
    "execucao": null,
    "tipoScore": "string",
    "descrPlano": "string",
    "descrScore": "string",
    "informante": "string",
    "modeloScore": null,
    "classificacaoABC": "string",
    "classificacaoNumero": "string",
    "probabilidadeInadimplencia": "string"
  },
  "nireUf": "string",
  "alertas": [
    {
      "tipo": "string",
      "titulo": "string",
      "observacao": "string"
    }
  ],
  "decisoes": {
    "layout": "string",
    "descricao": "string",
    "codigoSituacao": "string"
  },
  "situacao": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": null
    }
  ],
  "telefones": [],
  "restricoes": {
    "protestos": {
      "dataMaior": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "valorUltimo": null,
      "dataPrimeiro": null,
      "valorPrimeiro": null,
      "ultimoProtesto": null
    },
    "contumacia": {
      "quantidade": "string",
      "dataUltimaOcorrencia": null,
      "dataPrimeiraOcorrencia": null
    },
    "acoesCiveis": {
      "dataMaior": null,
      "dataMenor": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorMenor": null,
      "valorTotal": null,
      "ocorrencias": null,
      "valorUltimo": null,
      "dataPrimeira": null,
      "valorPrimeiro": null
    },
    "limiteCredito": {
      "texto": null,
      "valor": "string",
      "descricao": null
    },
    "chequesSemFundoBacen": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "faturamentoPresumido": {
      "faixa": null,
      "dataReferencia": null,
      "valorPresumido": null,
      "faturamentoAnual": null,
      "dadosCadastroPositivo": null
    },
    "chequesSemFundoVarejo": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "pendenciasFinanceiras": {
      "dataMaior": null,
      "provedores": [
        "string"
      ],
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "dataPrimeiro": null,
      "periodoFinal": null,
      "totalCredores": null,
      "valorPrimeiro": null,
      "periodoInicial": null,
      "ultimoVencimento": null
    },
    "falenciaRecuperacaoJudicial": {
      "quantidade": "string",
      "ocorrencias": null,
      "periodoFinal": null,
      "periodoInicial": null
    }
  },
  "governancas": {
    "socios": [
      {
        "nome": "string",
        "documento": "string",
        "tipoDocumento": "string",
        "situacaoDocumento": "string",
        "percentualParticipacao": "string"
      }
    ],
    "administradores": [
      {
        "nome": "string",
        "cargo": "string",
        "documento": "string",
        "dataEntrada": "string",
        "situacaoDocumento": "string"
      }
    ],
    "quantidadeSocios": "string",
    "quantidadeAdministradores": "string"
  },
  "indicadores": {
    "compromissos": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "creditoObtido": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "pagamentoPontual": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "pagamentoAtrasado": {
      "ocorrencias": [
        {
          "itens": [
            {
              "periodo": "string",
              "pontuacao_Mensal": null
            }
          ],
          "descricao": "string",
          "pontuacao": null
        }
      ]
    },
    "eventosPessoaJuridica": {
      "pontuacao": null,
      "ocorrencias": [
        {
          "periodo": "string",
          "indicador": "string",
          "pontuacao": "string"
        }
      ]
    },
    "periodoRelacionamentoFornecedores": {
      "pontuacao": null,
      "ocorrencias": [
        {
          "valor": "string",
          "periodo": "string"
        }
      ]
    }
  },
  "razaoSocial": "string",
  "cnaePrimario": "string",
  "dataFundacao": "string",
  "dataSituacao": "string",
  "nomeFantasia": "string",
  "capitalSocial": "string",
  "tipoSociedade": null,
  "cidadesFiliais": null,
  "cnaeSecundario": "string",
  "opcaoTributaria": null,
  "dataEncerramento": null,
  "naturezaJuridica": "string",
  "situacaoSintegra": "string",
  "faixaFuncionarios": null,
  "historicoConsulta": {
    "detalhes": [
      {
        "cnpj": null,
        "data": "string",
        "razaoSocial": "string"
      }
    ],
    "dataFinal": "string",
    "dataInicial": "string",
    "quantidadeOcorrencias": "string"
  },
  "inscricaoEstadual": "string",
  "quantidadeFiliais": "string",
  "inscricaoEstadualUf": "string",
  "razaoSocialAnterior": null,
  "dataConsultaSintegra": "string",
  "dataSituacaoSintegra": "string",
  "ramoAtividadePrimario": "string",
  "ramoAtividadeSecundario": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ da empresa."
    },
    "nire": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número de Identificação do Registro de Empresas."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Endereço de e-mail da empresa."
    },
    "porte": {
      "type": [
        "string",
        "null"
      ],
      "description": "Porte da empresa, referindo-se ao tamanho da mesma."
    },
    "score": {
      "type": "object",
      "properties": {
        "risco": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição do risco da empresa."
        },
        "score": {
          "type": [
            "string",
            "null"
          ],
          "description": "Pontuação numérica do score."
        },
        "texto": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição textual do score."
        },
        "layout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Layout do score."
        },
        "execucao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Informação sobre execução do score."
        },
        "tipoScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo de score avaliado."
        },
        "descrPlano": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição do plano."
        },
        "descrScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição do score."
        },
        "informante": {
          "type": [
            "string",
            "null"
          ],
          "description": "Provedor da informação de score."
        },
        "modeloScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Modelo utilizado para cálculo do score."
        },
        "classificacaoABC": {
          "type": [
            "string",
            "null"
          ],
          "description": "Classificação ABC da empresa."
        },
        "classificacaoNumero": {
          "type": [
            "string",
            "null"
          ],
          "description": "Classificação numérica da empresa."
        },
        "probabilidadeInadimplencia": {
          "type": [
            "string",
            "null"
          ],
          "description": "Probabilidade de inadimplência em percentual."
        }
      }
    },
    "nireUf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Estado de cadastro do NIRE."
    },
    "alertas": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "tipo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo do alerta."
          },
          "titulo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Título do alerta."
          },
          "observacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Observação detalhada do alerta."
          }
        }
      },
      "description": "Lista de alertas sobre a empresa."
    },
    "decisoes": {
      "type": "object",
      "properties": {
        "layout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Layout da decisão."
        },
        "descricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição da decisão recomendada."
        },
        "codigoSituacao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Código numérico da situação."
        }
      }
    },
    "situacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação atual da empresa."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade Federativa do endereço."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código de Endereçamento Postal."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro do endereço."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade do endereço."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do endereço."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logradouro do endereço."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "description": "Lista de endereços da empresa."
    },
    "restricoes": {
      "type": "object",
      "properties": {
        "protestos": {
          "type": "object",
          "properties": {
            "dataMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data do maior protesto."
            },
            "dataUltimo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data do último protesto."
            },
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de protestos."
            },
            "valorMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor do maior protesto."
            },
            "valorTotal": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor total dos protestos."
            },
            "ocorrencias": {
              "type": [
                "array",
                "null"
              ],
              "items": {},
              "description": "Lista de ocorrências de protestos."
            },
            "valorUltimo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor do último protesto."
            },
            "dataPrimeiro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data do primeiro protesto."
            },
            "valorPrimeiro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor do primeiro protesto."
            },
            "ultimoProtesto": {
              "type": [
                "string",
                "null"
              ],
              "description": "Informação sobre o último protesto."
            }
          }
        },
        "contumacia": {
          "type": "object",
          "properties": {
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de ocorrências de contumácia."
            },
            "dataUltimaOcorrencia": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da última ocorrência de contumácia."
            },
            "dataPrimeiraOcorrencia": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da primeira ocorrência de contumácia."
            }
          }
        },
        "acoesCiveis": {
          "type": "object",
          "properties": {
            "dataMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da maior ação cível."
            },
            "dataMenor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da menor ação cível."
            },
            "dataUltimo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da última ação cível."
            },
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de ações cíveis."
            },
            "valorMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da maior ação cível."
            },
            "valorMenor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da menor ação cível."
            },
            "valorTotal": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor total das ações cíveis."
            },
            "ocorrencias": {
              "type": [
                "array",
                "null"
              ],
              "items": {},
              "description": "Lista de ocorrências de ações cíveis."
            },
            "valorUltimo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da última ação cível."
            },
            "dataPrimeira": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da primeira ação cível."
            },
            "valorPrimeiro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da primeira ação cível."
            }
          }
        },
        "limiteCredito": {
          "type": "object",
          "properties": {
            "texto": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição textual do limite de crédito."
            },
            "valor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor do limite de crédito."
            },
            "descricao": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição do limite de crédito."
            }
          }
        },
        "chequesSemFundoBacen": {
          "type": "object",
          "properties": {
            "documento": {
              "type": [
                "string",
                "null"
              ],
              "description": "Documento do correntista."
            },
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de cheques sem fundo."
            },
            "tipoPessoa": {
              "type": [
                "string",
                "null"
              ],
              "description": "Tipo de pessoa (JURIDICA ou FISICA)."
            },
            "correntista": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome do correntista."
            }
          }
        },
        "faturamentoPresumido": {
          "type": "object",
          "properties": {
            "faixa": {
              "type": [
                "string",
                "null"
              ],
              "description": "Faixa de faturamento."
            },
            "dataReferencia": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data de referência do faturamento."
            },
            "valorPresumido": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor presumido do faturamento."
            },
            "faturamentoAnual": {
              "type": [
                "string",
                "null"
              ],
              "description": "Faturamento anual."
            },
            "dadosCadastroPositivo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Dados de cadastro positivo relacionados."
            }
          }
        },
        "chequesSemFundoVarejo": {
          "type": "object",
          "properties": {
            "documento": {
              "type": [
                "string",
                "null"
              ],
              "description": "Documento do correntista."
            },
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de cheques sem fundo."
            },
            "tipoPessoa": {
              "type": [
                "string",
                "null"
              ],
              "description": "Tipo de pessoa (JURIDICA ou FISICA)."
            },
            "correntista": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome do correntista."
            }
          }
        },
        "pendenciasFinanceiras": {
          "type": "object",
          "properties": {
            "dataMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da maior pendência."
            },
            "provedores": {
              "type": [
                "array",
                "null"
              ],
              "items": {},
              "description": "Provedores das informações de pendências."
            },
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de pendências financeiras."
            },
            "valorMaior": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da maior pendência."
            },
            "valorTotal": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor total das pendências."
            },
            "ocorrencias": {
              "type": [
                "array",
                "null"
              ],
              "items": {},
              "description": "Lista de ocorrências de pendências."
            },
            "dataPrimeiro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data da primeira pendência."
            },
            "periodoFinal": {
              "type": [
                "string",
                "null"
              ],
              "description": "Período final das pendências."
            },
            "totalCredores": {
              "type": [
                "string",
                "null"
              ],
              "description": "Total de credores."
            },
            "valorPrimeiro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor da primeira pendência."
            },
            "periodoInicial": {
              "type": [
                "string",
                "null"
              ],
              "description": "Período inicial das pendências."
            },
            "ultimoVencimento": {
              "type": [
                "string",
                "null"
              ],
              "description": "Último vencimento das pendências."
            }
          }
        },
        "falenciaRecuperacaoJudicial": {
          "type": "object",
          "properties": {
            "quantidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Quantidade de ocorrências de falência ou recuperação."
            },
            "ocorrencias": {
              "type": [
                "array",
                "null"
              ],
              "items": {},
              "description": "Lista de ocorrências."
            },
            "periodoFinal": {
              "type": [
                "string",
                "null"
              ],
              "description": "Período final."
            },
            "periodoInicial": {
              "type": [
                "string",
                "null"
              ],
              "description": "Período inicial."
            }
          }
        }
      }
    },
    "governancas": {
      "type": "object",
      "properties": {
        "socios": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "nome": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome do sócio."
              },
              "documento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Documento do sócio."
              },
              "tipoDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo de documento (CPF ou CNPJ)."
              },
              "situacaoDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Situação do documento do sócio."
              },
              "percentualParticipacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Percentual de participação do sócio."
              }
            }
          },
          "description": "Lista de sócios da empresa."
        },
        "administradores": {
          "type": [
            "array",
            "null"
          ],
          "items": {},
          "description": "Lista de administradores da empresa."
        },
        "quantidadeSocios": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade total de sócios."
        },
        "quantidadeAdministradores": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade total de administradores."
        }
      }
    },
    "razaoSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social da empresa."
    },
    "cnaePrimario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código do CNAE principal da empresa."
    },
    "dataConsulta": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data e hora da consulta."
    },
    "dataFundacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de fundação da empresa."
    },
    "dataSituacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da situação atual da empresa."
    },
    "nomeFantasia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome fantasia da empresa."
    },
    "capitalSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Capital social da empresa."
    },
    "tipoSociedade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo de sociedade da empresa."
    },
    "cidadesFiliais": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cidades onde a empresa possui filiais."
    },
    "cnaeSecundario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código do CNAE secundário da empresa."
    },
    "opcaoTributaria": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opção tributária da empresa."
    },
    "dataEncerramento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de encerramento da empresa."
    },
    "naturezaJuridica": {
      "type": [
        "string",
        "null"
      ],
      "description": "Natureza jurídica da empresa."
    },
    "situacaoSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação da empresa perante o Sintegra."
    },
    "faixaFuncionarios": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa estimada de funcionários."
    },
    "historicoConsulta": {
      "type": "object",
      "properties": {
        "detalhes": {
          "type": [
            "array",
            "null"
          ],
          "items": {},
          "description": "Detalhes do histórico."
        },
        "dataFinal": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data final do período consultado."
        },
        "dataInicial": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data inicial do período consultado."
        },
        "quantidadeOcorrencias": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de ocorrências no histórico."
        }
      }
    },
    "inscricaoEstadual": {
      "type": [
        "string",
        "null"
      ],
      "description": "Inscrição estadual da empresa."
    },
    "quantidadeFiliais": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quantidade de filiais da empresa."
    },
    "inscricaoEstadualUf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade Federativa da inscrição estadual."
    },
    "razaoSocialAnterior": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social anterior da empresa."
    },
    "dataConsultaSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da consulta ao Sintegra."
    },
    "dataSituacaoSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da situação perante o Sintegra."
    },
    "ramoAtividadePrimario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição do ramo de atividade primário."
    },
    "ramoAtividadeSecundario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição do ramo de atividade secundário."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - A consulta gera um comprovante em PDF que pode ser obtido através de parâmetro adicional na requisição.
> - Todos os campos de data seguem o formato `dd/MM/yyyy`.
> - Valores monetários são retornados em texto com indicação de moeda.
> - Ocorrências e listas são retornadas como arrays com múltiplos registros quando aplicável.
> - Períodos e períodos de relacionamento são expressos em intervalos de tempo.
> - O acesso requer autenticação via token.

---

Página em HTML: https://fontedata.com/docs/credito-e-score/boa-vista-risco-pj
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp