Documentos e comunicados (IPE/CVM)
Fatos relevantes, comunicados e documentos protocolados na CVM (IPE) da companhia. Aceita ticker (BBAS3), código CVM (1023) ou CNPJ de 14 dígitos (10531501000158). Filtre por `kind` (taxonomia estável), `category` (texto bruto da fonte) e período (`from`/`to`); paginação por cursor.
In: header
Path Parameters
Ticker do papel (BBAS3), código CVM numérico da companhia (1023) OU CNPJ de 14 dígitos (10531501000158). O CNPJ é a porta para a companhia SEM ação em bolsa: quem se registra na CVM apenas para emitir dívida (Categoria B) entrega demonstração financeira completa e não tem ticker. Debênture, FIDC e informe de securitização identificam o emissor por CNPJ, nunca por cd_cvm.
1 <= length <= 32Query Parameters
1001 <= value <= 1000true = inclui meta.total (contagem do universo filtrado). Custa uma consulta a mais.
Tipo estável do documento (mesma taxonomia do campo kind da resposta). Prefira este filtro a category: a categoria é texto livre em português e muda com a fonte.
"material_fact" | "market_communication" | "financial_report" | "shareholder_notice" | "shareholder_meeting" | "periodic_report" | "management_report" | "debt_instrument" | "governing_document" | "other"Categoria bruta do documento no IPE/CVM, ex.: 'Fato Relevante', 'Comunicado ao Mercado', 'Aviso aos Acionistas', 'Assembleia', 'Dados Econômico-Financeiros'.
Filtra a DATA DE REFERÊNCIA do documento (período a que ele se refere), não a de protocolo — um DFP do exercício 2022 é entregue em 2023 e aparece em from/to de 2022. A data de entrega segue no campo filed_at de cada documento.
^\d{4}-\d{2}-\d{2}$Fim do período (data de referência, inclusive).
^\d{4}-\d{2}-\d{2}$Response Body
curl -X GET "https://api.databolsa.com/v1/companies/string/documents?cursor=string&limit=100&total=string&kind=material_fact&category=string&from=string&to=string"{
"data": [
{
"cvm_code": 0,
"kind": "material_fact",
"category": "string",
"type": "string",
"subject": "string",
"reference_date": "string",
"filed_at": "string",
"protocol": "string",
"download_url": "string"
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
}
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}Lista companhias abertas (cadastro CVM)
Previous Page
Demonstrações financeiras estruturadas (TTM + balanço)
Aceita ticker (BBAS3), código CVM (1023) ou CNPJ de 14 dígitos (10531501000158). O CNPJ é a porta para a companhia SEM ação em bolsa: quem se registra na CVM apenas para emitir dívida (Categoria B) entrega a mesma demonstração trimestral e não tem ticker — e debênture, FIDC e informe de securitização identificam o emissor por CNPJ. Séries estruturadas por trimestre (CVM DFP/ITR): fluxos em TTM (receita, EBIT, EBITDA, lucro, caixa operacional/livre, capex) e balanço ponto-no-tempo (ativos, caixa, dívida, patrimônio). Valores em R$ (unidade), escopo consolidado e controladora. `filed_at` traz a 1ª publicação na CVM para corte point-in-time sem lookahead. `from`/`to` filtram ref_date; paginação por cursor.