O endpoint /api/CVM permite consultar dados cadastrais de participantes autorizados pela CVM, retornando informações como registro, situação, categorias de atuação e estrutura administrativa.
CVM - Comissão de Valores Mobiliários
A Consulta de Dados Cadastrais da CVM apresenta o detalhamento do registro, a situação cadastral e os múltiplos perfis de atuação (como corretoras, gestores e custodiantes) dos participantes autorizados a operar no mercado de valores mobiliários cadastrados no órgão.
Casos de Uso
- Processos de compliance e ESG
- Validação de participantes do mercado financeiro
- Due diligence de empresas e instituições
- Análise de risco regulatório
- Monitoramento de entidades autorizadas pela CVM.
Aplicações
- Compliance/ESG
Benefícios
- Acesso a dados oficiais da CVM
- Identificação de situação cadastral e regulatória
- Visibilidade sobre perfis de atuação no mercado financeiro
- Apoio à tomada de decisão em compliance
- Integração simples com sistemas internos.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/CVMComissaodeValoresMobiliariosEndpoint
GET https://apiv3.directd.com.br/api/CVMComissaodeValoresMobiliarios?CPF={0}&CNPJ={1}&Token=Seu_TokenDescrição: Endpoint para realizar consultas CVM - Comissão de Valores Mobiliários.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Bairro: Bairro do endereço
- Categoria: Nome da Categoria
- Categoria de Registro: Informa a categoria do registro.
- CEP: Número CEP do endereço
- Cidade: Cidade do registro em questão
- Código do CVM: Informa o código do CVM.
- Companhia de Menor Porte: Informa se a entidade é uma companhia de menor porte.
- Data da Situação: Informa a data em que a empresa ficou com a devida situação.
- Data de Início: Data de Início do registro
- Data de Início na Categoria: Informa a data do início da categoria.
- Data de Registro: Informa a data de registro da sanção.
- Data do Pratimônio Liquido: Informa a data do patrimônio liquido.
- Documento Consultado: Documento consultado referente ao CPF/CNPJ
- Endereço: Informa o endereço do indivíduo
- Instrução: Informa a instrução exercida pela entidade.
- Lista de Diretores: Retorna uma lista de diretores.
- Lista de Tipos de Participante: Retorna uma lista constando todos os tipos de participantes.
- Nome: Nome do indivíduo/registro
- Nome Entidade: Nome da entidade ou Razão Social consultada
- Patrimônio Liquido: Informa o valor do patrimônio liquido.
- Situação: Situação do registro em questão
- Telefone: Número de telefone do indivíduo ou entidade
- UF: Unidade Federativa (estado) referente ao registro
- Website: Informa a endereço URL do website.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"documentoConsultado": "string",
"nomeEntidade": "string",
"endereco": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string",
"telefone": "string",
"dataRegistro": "string",
"patrimonioLiquido": "string",
"dataPatrimonioLiquido": "string",
"situacao": "string",
"dataSituacao": "string",
"codigoCVM": "string",
"categoriaRegistro": "string",
"dataInicioNaCategoria": "string",
"companhiaDeMenorPorte": "string",
"website": "string",
"categoria": "string",
"tiposParticipante": [
"string"
],
"diretores": [
{
"nome": "string",
"dataInicio": "string",
"instrucao": "string"
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
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. |
Notas Importantes
- Informe apenas um único documento por requisição
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228