GETEstavel/company/{cd_cvm}

Consultar companhia

Retorna os dados cadastrais e a classificacao setorial de uma companhia pelo codigo CVM.

Parametros

Parametros de path

Nome	Tipo	Exigencia	Descricao
cd_cvm	string	Obrigatorio	Codigo CVM da companhia.

Resposta

Sucesso HTTP: 200

Resposta ilustrativa. Valores e datas fictícios; não representa uma consulta atual.

{
  "name": "Petroleo Brasileiro S.A.",
  "sector": "Petroleo, Gas e Biocombustiveis",
  "status": "ATIVO",
  "cnpj": "33000167000101",
  "subsector": "Petroleo, Gas e Biocombustiveis",
  "segment": "Exploracao, Refino e Distribuicao",
  "web_site": "https://petrobras.com.br"
}

Erros

Status	Descricao
400	Parametros ou corpo da requisicao invalidos.
404	Recurso solicitado nao encontrado.
204	Nenhum dado encontrado para os criterios informados.
401	Chave de API ausente ou invalida.
403	Uma assinatura paga ativa e necessaria para acessar a API.
429	Limite de requisicoes excedido.
500	Erro interno inesperado.
503	Servico temporariamente indisponivel. Tente novamente mais tarde.

Relacionados

MCP relacionado: Consultar companhia

// Node.js — execute no servidor const apiKey = process.env.CRIVO_API_KEY; if (!apiKey) throw new Error("Defina CRIVO_API_KEY"); const response = await fetch("https://api.crivo.ai/company/9512", { method: "GET", headers: { "X-API-Key": apiKey } }); if (!response.ok) throw new Error(`HTTP ${response.status}`); console.log(await response.json());

import os import requests response = requests.get( "https://api.crivo.ai/company/9512", headers={"X-API-Key": os.environ["CRIVO_API_KEY"]}, timeout=30, ) response.raise_for_status() print(response.json())