---
title: "Comparar receitas por atividade"
method: GET
path: "/api/v2/revenue-sources/compare"
tags: ["Ações"]
---

# Comparar receitas por atividade

`GET /api/v2/revenue-sources/compare`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/revenue-sources/compare`
- Auth: HTTP bearer

Todos os emissores com receita em uma atividade e nas atividades filhas, com o crescimento por exercício. A receita de vários segmentos do mesmo emissor é somada.

Para concessões, o crescimento não usa a receita de construção (`basis` = `exConstruction`) quando ela é conhecida em todos os segmentos. Nos demais casos, `flags` traz `includes-construction`.

Os valores ficam na moeda de cada emissor. Compare o crescimento, não os valores. Receitas que já aparecem em uma controlada listada ficam de fora.

Bancos e seguradoras não entram: suas receitas não se comparam. Pedir essas atividades retorna erro 400.

Planos Startup e Pro. FIIs, Fiagros e fundos só no plano Pro. PETR4, MGLU3, VALE3 e ITUB4 permitem testes gratuitos, sem token.

## Query parameters

- `activity` string, required: Código da atividade. Inclui as atividades filhas. Veja os códigos em `/api/v2/revenue-sources/activities`.
- `startYear` integer: Primeiro exercício social. Padrão: o mais antigo disponível.
- `endYear` integer: Último exercício social. Padrão: o mais recente disponível.

## Response `200`

Emissores do maior para o menor crescimento.

- RevenueCompareResponse
  - `activity` RevenueActivity, required
    - `code` string, required
    - `label` string, required
    - `cnae` string, nullable, required: Classe ou divisão CNAE mais próxima. É uma referência.
    - `parent` string, nullable, required: Código da atividade mãe. null no primeiro nível.
    - `constructionRevenue` boolean, required: true para concessões que registram o investimento na rede como receita de construção. O crescimento em `compare` não usa essa receita.
    - `comparable` boolean, required: false para bancos e seguradoras, cujas receitas não se comparam. `compare` recusa essas atividades.
  - `issuers` RevenueCompareIssuer[], required: Emissores com receita na atividade, do maior para o menor crescimento no último exercício. Compare o crescimento: os valores podem estar em moedas diferentes.
    - `issuerCode` string, required
    - `name` string, required
    - `type` 'company' | 'bdr' | 'fii' | 'fiagro', required
    - `currency` string, required
    - `latestYear` integer, required
    - `latestValue` number, required
    - `latestGrowth` number, nullable, required
    - `years` RevenueCompareYear[], required: Exercícios do mais recente para o mais antigo.
      - `fiscalYear` integer, required
      - `value` number, required: Receita da atividade no exercício, na moeda do emissor.
      - `valueExConstruction` number, nullable, required: Receita sem a receita de construção. Preenchido quando `basis` é `exConstruction`.
      - `priorValue` number, nullable, required: Receita do ano anterior, na mesma base de `growth`.
      - `growth` number, nullable, required: Crescimento sobre o ano anterior, em fração (0.06 = 6%).
      - `basis` 'reported' | 'exConstruction', required: `exConstruction` quando o crescimento não usa a receita de construção. `reported` nos demais casos.
      - `flags` string[], required: Alertas sobre o valor. `unchecked`: a soma dos segmentos não confere com a receita total. `relabeled`: uma conferência moveu o valor para outro segmento. `reviewed`: uma pessoa conferiu o segmento. `label-disputed`: duas leituras deram nomes diferentes ao segmento. `duplicate`: a mesma receita aparece em uma controlada listada. `includes-construction`: o valor inclui receita de construção.
      - `segments` string[], required: Segmentos somados, como a empresa publica.
      - `source` object, required
        - `form` string, required: Documento de origem: `dfp` (demonstrações anuais na CVM), `10-K`, `20-F` ou `40-F` (relatório anual na SEC) ou `fii-quarterly` (informes trimestrais de FIIs na CVM).
        - `documentId` string, required: Protocolo ou número do documento na origem.
        - `url` string, nullable, required: Link do documento.
        - `page` integer, nullable, required: Página do valor no documento, quando conhecida.
  - `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-02** `7c732d79148a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/revenue-sources/compare/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)