# Brazil financials

> Brazilian company financial figures from CVM.

Available on paid plans: an API key is required. Coverage: 1,217 companies registered with CVM, fiscal years 2010 to 2027.

- `GET /v1/br/companies/{id}`: company profile; 1 credit per record.
- `GET /v1/br/companies/{id}/financials?field=&period=&limit=&cursor=`: figures; 1 credit when points are returned. Errors and empty results are free.

Use a 14-digit CNPJ (also accepted as `NN.NNN.NNN/NNNN-NN`, with the slash URL-encoded), a 1 to 6-digit CVM code, or a B3 ticker (case insensitive). A company's other share classes resolve to the same company.

`register_status` is null when the company has no entry in CVM's register.

For the keyed financials route, `field` is optional. `period` is `all` (default), `annual` (FY), or `quarterly` (Q1, Q2, Q3). `limit` is 1..100 (default 40). Follow `meta.next_cursor` with the same id and filters. Newest period first; amounts are exact decimal strings.

| Field | Meaning | Unit |
|---|---|---|
| revenue | Net sales and services (commercial companies only) | BRL |
| cost_of_revenue | Cost of goods and services sold (positive) | BRL |
| gross_profit | Printed gross result | BRL |
| operating_income | Result before financial result and taxes | BRL |
| pretax_income | Result before income taxes | BRL |
| income_tax | Income tax and social contribution expense (expense positive, benefit negative) | BRL |
| net_income | Consolidated profit including minority holders | BRL |
| net_income_attributable | Profit attributable to controlling shareholders (whole profit when derivation is equals_consolidated) | BRL |
| basic_eps | Basic earnings per share | BRL/share |
| diluted_eps | Diluted earnings per share | BRL/share |
| financial_intermediation_income | Banks' printed gross income of financial intermediation (banks print no revenue line) | BRL |
| financial_intermediation_result | Banks' printed gross result of financial intermediation | BRL |
| insurance_activities_income | Insurers' printed income of insurance activities | BRL |
| operating_cash_flow | Net cash from operating activities (Q2 and Q3 are year-to-date differences) | BRL |
| investing_cash_flow | Net cash from investing activities (Q2 and Q3 are year-to-date differences) | BRL |
| financing_cash_flow | Net cash from financing activities (Q2 and Q3 are year-to-date differences) | BRL |
| cash_and_equivalents | Cash and equivalents | BRL |
| current_assets | Current assets | BRL |
| receivables | Trade receivables | BRL |
| inventory | Inventory | BRL |
| ppe_net | Property, plant and equipment | BRL |
| intangibles | Intangibles excluding goodwill | BRL |
| goodwill | Goodwill | BRL |
| total_assets | Total assets | BRL |
| current_liabilities | Current liabilities | BRL |
| accounts_payable | Trade payables | BRL |
| short_term_debt | Loans and financing due within a year | BRL |
| total_equity | Total equity including minority holders | BRL |

Consolidated statements, annual and Q1-Q3 quarterly figures. No fourth-quarter figure is served; the annual figure covers the year. A field a company's own statement does not print is absent. A company with no subsidiaries files only an individual statement; its figures say `statement_scope: individual`.

Contains information from CVM (Comissão de Valores Mobiliários), Dados Abertos, Cias Abertas (DFP, ITR, cadastro, FCA), accessed through the CVM Open Data Portal https://dados.cvm.gov.br/ and made available under the Open Database License (ODbL) 1.0 https://opendatacommons.org/licenses/odbl/1-0/. Belfort Research selected accounts, converted units and derived some quarterly cash flows; this modified Brazil database is available under the same licence at https://api.belfortagent.xyz/v1/br/download. Not endorsed by CVM.

---
Source: https://docs.belfortagent.xyz/datasets/br-financials/
