Statistics Statements
Retrieves the filing details of each financial statement period: the reported currency, the CIK, the filing and acceptance dates, the fiscal period and the links to the filing. With convert_currency, the Toolkit uses the reported currency to convert the financial statements to the currency of the historical data.
Note that this also obtains the balance sheet statement at the same time given that it’s the same API call. This is done to reduce the number of API calls to FinancialModelingPrep.
Also known as: filing details, reporting metadata, reported currency.
Statistics Statements in Python or via the MCP
Install the Finance Toolkit with:
pip install financetoolkit -U
Then call get_statistics_statement as shown below.
from financetoolkit import Toolkit
toolkit = Toolkit(
["KO", "PEP"],
api_key="FINANCIAL_MODELING_PREP_KEY",
start_date="2021-01-01",
end_date="2025-12-31",
)
toolkit.get_statistics_statement(show_columns=["Accepted Date"]).T
Or, after setting up the Finance Toolkit MCP, ask:
When did the SEC accept the annual reports of Coca-Cola and PepsiCo for 2020 to 2025?
Which returns:
| date | KO | PEP |
|---|---|---|
| 2021 | 2022-02-22 15:45:48 | 2022-02-09 18:03:39 |
| 2022 | 2023-02-21 16:03:20 | 2023-02-08 18:06:37 |
| 2023 | 2024-02-20 13:21:24 | 2024-02-08 17:58:51 |
| 2024 | 2025-02-20 15:17:12 | 2025-02-03 18:22:47 |
| 2025 | 2026-02-20 09:46:32 | 2026-02-02 18:07:04 |
Parameters
get_statistics_statement accepts the following parameters.
| Parameter | Type | Description | Example |
|---|---|---|---|
enforce_source | str | None | Forces this specific call to use a given source, either “FinancialModelingPrep” or “YahooFinance”. This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from the free Yahoo Finance source while still using a FinancialModelingPrep key for the financial statements (or the other way around). Defaults to None, which falls back to the Toolkit’s own enforce_source. | "YahooFinance" |
overwrite | bool | Defines whether to overwrite the existing data. Defaults to False. | True |
rounding | int | Defines the number of decimal places to round the data to. Defaults to None, which uses the rounding of the Toolkit (4 unless set otherwise). | 2 |
show_columns | list[str] | None | A list of column names to keep in the result. Invalid names are reported and ignored. Defaults to None, which keeps every column. | ["Filing Date", "Fiscal Year"] |