v1

latestOpenAPI 3.0.12026-07-1414421.5 KB
Financial Statements

Financial Statements (Verbose)

Get financial statements, verbose format (array of JSON objects)

get/api/v3/companies/statements/verbose

Query parameters

idnumber[]

SimFin Id(s), comma separated

[
  470
]
tickerstring[]

Tickers, comma separated

[
  "AAPL"
]
statementsstring[] required

List of statements (comma separated), available values: pl (Profit & Loss), bs (Balance Sheet), cf (Cash Flow), derived (Derived Ratios and Indicators)

periodstring[]

List of time periods (comma separated), available values: q1, q2, q3, q4, fy, h1, h2, nine_month. If you want to retrieve all quarterly periods for example, you would use period=q1,q2,q3,q4

fyearstring
Example:2021,2023

List of financial years (comma separated). This the fiscal year of the company, not the calendar year.

startstring
Example:2012-01-01

Filter for date range, starting date. E.g. setting starting date as 2012-01-01 would only retrieve statements with a reporting period ending AFTER 1st of January 2012 (so statements ending in December 31st 2011 would be excluded)

endstring
Example:1999-12-31

Filter for date range, ending date. E.g. setting ending date as 2012-01-01 would only retrieve statements with a reporting period ending BEFORE 1st of January 2012 (so statements ending in December 31st 2011 would be excluded)

ttmboolean

Retrieves trailing twelve month periods

asreportedboolean

Retrieves the statements as-reported (not restated).

Headers

Authorizationstring required

Example: "api-key ovBimDZTPrKdG9Yx58GjQf2A"

Response

Success