Filings

GET

/companies/[companyIdentifier]/filings

Retorna os filings da empresa: os documentos que ela entregou ao regulador (fatos relevantes, comunicados ao mercado, atas, assembleias, releases de resultados, avisos aos acionistas e as demais categorias), com o conteúdo transcrito de cada documento e o histórico de versões.

Hoje a fonte é o sistema IPE da CVM. Cada versão informa de onde veio em source[].regulator e source[].system.

O conteúdo é texto em Markdown. Páginas de texto corrido vêm da camada de texto do PDF; tabelas, gráficos e páginas digitalizadas são transcritos por um modelo de visão, com as tabelas em formato Markdown.

Acesso

Este endpoint exige o escopo @companies/filings/get na chave de API. A cobertura é de documentos entregues desde 2010.

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[companyIdentifier]	URL	Identificador da empresa: symbol (PETR), ticker (PETR4), company_id (CNPJ) ou código CVM (9512).	Obrigatório
start_date	Query	ISO 8601. Documentos com publish_date (da versão atual) a partir desta data.	Opcional
end_date	Query	ISO 8601. Documentos com publish_date (da versão atual) até esta data.	Opcional
document_type	Query	Um ou mais document_type.id, separados por vírgula (ex.: MATERIAL_FACT,MARKET_ANNOUNCEMENT). Veja tipos de documento.	Opcional
versions	Query	all (padrão) devolve todas as versões capturadas; current só a versão atual.	Opcional
limit	Query	Documentos por página, de 1 a 50. Padrão: 10.	Opcional
offset	Query	Quantos documentos pular. Padrão: 0.	Opcional

Os documentos vêm do mais recente para o mais antigo. Para percorrer todos, aumente offset em limit até a resposta voltar vazia.

Para buscar um filing pelo id da resposta, use GET /v2/companies/[companyIdentifier]/filings/[id]. O parâmetro versions também vale nessa rota.

Resposta

Código	Descrição
200	Retorna a lista de filings (ou o filing).
400	Parâmetros inválidos.
401	Não autorizado.
403	A chave não tem acesso a este endpoint ou empresa.
404	Empresa ou filing não encontrado.

Formato da resposta

Cada filing tem os campos abaixo. content e source são listas alinhadas: content[i] é o texto da versão descrita em source[i]. A versão mais recente vem primeiro.

Campo	Tipo	Descrição
id	string	Identificador do filing (para a CVM, o protocolo do RAD).
name	string	Razão social da empresa no cadastro do regulador.
company_id	string	CNPJ da empresa, só dígitos.
document_type.id	string	Identificador estável do tipo de documento (ex.: MATERIAL_FACT).
document_type.display_name	string	Nome da categoria no regulador (ex.: Fato Relevante).
content	string[]	Conteúdo transcrito de cada versão, em Markdown.
source[].regulator	string	Regulador que recebeu o documento (ex.: CVM).
source[].system	string	Sistema do regulador de onde o documento veio (ex.: IPE).
source[].reference_date	string (ISO 8601)	Data de referência informada na entrega.
source[].publish_date	string (ISO 8601)	Data e hora da entrega à CVM.
source[].retrieved_at	string (ISO 8601)	Quando a Partnr capturou esta versão.
source[].current	boolean	true na versão atual do documento.
source[].version	string | null	Número da versão no regulador. null em entregas anteriores a 2015, que o RAD não numera.
source[].protocol	string	Número do protocolo no regulador (RAD, para a CVM).
source[].resubmission_reason	string | null	Motivo da reapresentação informado pela empresa, quando houver.
source[].visualization_url	string	Página do documento no regulador.
source[].download_url	string	Download do arquivo original.

Histórico de versões

Quando a empresa reapresenta um documento, a nova versão entra na frente de source e de content e passa a ser a current. As versões anteriores continuam na resposta.

No IPE, a CVM só publica a versão atual de cada documento. Por isso o histórico vale a partir da captura pela Partnr: documentos reapresentados antes disso trazem só a versão atual.

Exemplo

[
  {
    "id": "1577247",
    "name": "WESTWING COMÉRCIO VAREJISTA S.A.",
    "company_id": "14776142000150",
    "document_type": {
      "id": "MATERIAL_FACT",
      "display_name": "Fato Relevante"
    },
    "content": [
      "WESTWING COMÉRCIO VAREJISTA S.A.\nCNPJ/MF nº 14.776.142/0001-50\n(B3: WEST3)\n\nFATO RELEVANTE\n\nConvocação de Assembleia Geral Extraordinária – Pedido de Acionista\n\n..."
    ],
    "source": [
      {
        "regulator": "CVM",
        "system": "IPE",
        "reference_date": "2026-10-14T03:00:00.000Z",
        "publish_date": "2026-10-14T23:25:40.000Z",
        "retrieved_at": "2026-10-14T23:29:12.000Z",
        "current": true,
        "version": "1",
        "protocol": "1577247",
        "resubmission_reason": null,
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1577247",
        "download_url": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1577247&numSequencia=1101953&numVersao=1"
      }
    ]
  }
]

Tipos de documento

As categorias mais comuns da CVM. Uma categoria que o regulador criar depois vem com id igual a OTHER e o nome original em display_name.

document_type.id	Categoria na CVM
MATERIAL_FACT	Fato Relevante
MARKET_ANNOUNCEMENT	Comunicado ao Mercado
NOTICE_TO_SHAREHOLDERS	Aviso aos Acionistas
NOTICE_TO_DEBENTURE_HOLDERS	Aviso aos Debenturistas
SHAREHOLDERS_MEETING	Assembleia
MANAGEMENT_MEETING	Reunião da Administração
FINANCIAL_DATA	Dados Econômico-Financeiros
CORPORATE_EVENTS_CALENDAR	Calendário de Eventos Corporativos
DIVIDENDS_REPORT	Relatório Proventos
INSIDER_HOLDINGS	Valores Mobiliários negociados e detidos (art. 11 da Instr. CVM nº 358)
BYLAWS	Estatuto Social
SHAREHOLDERS_AGREEMENT	Acordo de Acionistas
RELATED_PARTY_TRANSACTION	Comunicação sobre Transação entre Partes Relacionadas
PUBLIC_OFFERING_DOCUMENTS	Documentos de Oferta de Distribuição Pública
DEBENTURE_INDENTURE	Escrituras e aditamentos de debêntures
FOREIGN_EXCHANGE_FILING	Informação Prestada às Bolsas Estrangeiras
JUDICIAL_RECOVERY_INFORMATION	Informações de Companhias em Recuperação Judicial ou Extrajudicial
SUSTAINABILITY_REPORT	Relatório de Sustentabilidade
CODE_OF_CONDUCT	Código de Conduta
DISCLOSURE_POLICY	Política de Divulgação de Ato ou Fato Relevante