--- title: "Calendário de resultados" method: GET path: "/api/v2/stocks/earnings-calendar" tags: ["Ações"] --- # Calendário de resultados `GET /api/v2/stocks/earnings-calendar` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/stocks/earnings-calendar` - Auth: HTTP bearer Datas de divulgação dos resultados trimestrais (ITR) e anuais (DFP) das empresas listadas na B3 e das empresas estrangeiras com BDRs. A atualização ocorre duas vezes por dia. Cada item é uma divulgação de uma empresa, com todos os seus tickers. `date` traz a data real quando os resultados já foram entregues e a data prevista nos demais casos. `dateChanges` mostra quando a empresa mudou a data. Para BDRs, a data real é a do comunicado de resultados da empresa. `releaseTime` mostra o horário em relação ao pregão de Nova York. As próximas datas de BDRs são estimadas (`dateStatus` = `estimated`) com a data do mesmo período no ano anterior. `fiscalYear` e `fiscalPeriod` indicam o período dos resultados. Empresas com exercício fora do ano civil usam o ano em que o exercício termina. Sem `symbols`, o intervalo máximo é de 366 dias. Com `symbols`, ele é de 10 anos. Use `updatedSince` para receber só as divulgações alteradas. Todos os planos. PETR4, MGLU3, VALE3 e ITUB4 permitem testes gratuitos, sem token. ## Query parameters - `symbols` string: Tickers separados por vírgula, de ações ou BDRs. Máximo de 20. PETR3 e PETR4 retornam a mesma empresa. - `from` string: Data inicial de divulgação. Padrão: 7 dias antes de hoje, ou 97 dias antes de `to`. O intervalo máximo é de 366 dias, ou de 10 anos com `symbols`. - `to` string: Data final de divulgação. Padrão: 97 dias depois de `from` (90 dias depois de hoje). - `types` 'quarterly' | 'annual': `quarterly` (trimestral) ou `annual` (anual). Para mais de um, separe por vírgula. - `status` 'scheduled' | 'published' | 'overdue': `scheduled` (prevista), `published` (divulgada) ou `overdue` (atrasada). Para mais de uma, separe por vírgula. - `dateStatus` 'confirmed' | 'estimated': `confirmed` traz datas informadas pela empresa. `estimated` traz datas estimadas. - `updatedSince` string, date-time: Retorna só divulgações alteradas a partir deste momento, em ISO 8601. Use para sincronizar sua base. - `page` integer: Página. - `limit` integer: Máximo de divulgações por página. ## Response `200` Divulgações por data, da mais antiga para a mais recente. - EarningsCalendarResponse - `results` EarningsEvent[], required - `id` string, required: Identificador estável da divulgação. - `issuerCode` string, required: Código da empresa na B3. - `companyName` string, required - `tickers` string[], required: Tickers negociados da empresa. - `fiscalYear` integer, required: Exercício social. Empresas com exercício fora do ano civil usam o ano em que o exercício termina. - `fiscalPeriod` 'Q1' | 'Q2' | 'Q3' | 'H1' | 'FY', required: Período do exercício. `FY` é o exercício completo, que inclui o 4º trimestre. `H1` é o 1º semestre, para empresas que divulgam resultados semestrais. - `periodEnd` string, required: Último dia do período. - `date` string, required: Data de divulgação: a data real quando houver, senão a data prevista. - `dateStatus` 'confirmed' | 'estimated', required: `confirmed` quando a empresa informou ou já divulgou a data. `estimated` quando a data é uma estimativa, feita com a data do mesmo período no ano anterior. - `status` 'scheduled' | 'published' | 'overdue', required: `published` quando os resultados foram entregues. `overdue` quando a data passou há mais de 2 dias úteis sem entrega. `scheduled` nos demais casos. - `plannedDate` string, nullable, required: Última data prevista no calendário da empresa. - `reportedDate` string, nullable, required: Data em que os resultados foram entregues. - `filingDate` string, nullable, required: Data de entrega das demonstrações financeiras. - `callDate` string, nullable, required: Data da apresentação pública dos resultados. - `releaseTime` 'beforeMarket' | 'duringMarket' | 'afterMarket', nullable, required: Horário da divulgação em relação ao pregão de Nova York (09h30 às 16h00, horário local): `beforeMarket`, `duringMarket` ou `afterMarket`. Só para BDRs. null quando não informado. - `dateChanges` EarningsDateChange[], required: Mudanças de data, da mais antiga para a mais recente. - `field` 'date' | 'callDate', required: `date` para a data de divulgação, `callDate` para a apresentação de resultados. - `from` string, required - `to` string, required - `announcedAt` string, required: Data em que a empresa informou a mudança. - `links` object, required - `calendar` string, nullable, required: Calendário de eventos de onde vem a data prevista. - `document` string, nullable, required: Documento com os resultados entregues. - `updatedAt` string, required: Momento da última mudança nesta divulgação. - `pagination` object, required - `page` integer, required - `limit` integer, required - `total` integer, required - `hasMore` boolean, required - `from` string, required - `to` string, required - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `429`: Limite de requisições excedido. - `500`: Erro interno do servidor. - `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos. ## Changes - **2026-11-01** `a2090d3b7ebe`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/stocks/earnings-calendar/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)