Skip to main content
GET
Get Financial Statements
All three statements for one company in a single call. Returns a financials object holding income_statements, balance_sheets and cash_flow_statements, each the same shape the dedicated tools return. period is required (annual, quarterly or ttm); identify the company by ticker or cik and cap with limit. Use it when you need the full picture and would otherwise make three calls. When you only need one statement, get_financial_financials_income_statements, get_financial_financials_balance_sheets or get_financial_financials_cash_flow_statements returns far less data; when you need a handful of named fields across several companies, post_financial_financials_search_line_items is narrower still.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/financial/financials
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/financial/financials
  • cik: query; optional
  • cursor: query; optional
  • exchange: query; optional
  • filing_date: query; optional
  • filing_date_gt: query; optional
  • filing_date_gte: query; optional
  • filing_date_lt: query; optional
  • filing_date_lte: query; optional
  • isin: query; optional
  • limit: query; optional
  • market: query; optional
  • period: query; required
  • report_period: query; optional
  • report_period_gt: query; optional
  • report_period_gte: query; optional
  • report_period_lt: query; optional
  • report_period_lte: query; optional
  • ticker: query; optional
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Request pricing. Default request estimate: $0.02 USD. The final charge depends on actual usage. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cik
string

The Central Index Key (CIK) of the company.

cursor
string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

exchange
string

Deprecated alias of market: LSE means market=UK. Existing requests keep working. France has no alias: name it with market=FR.

filing_date
string<date>

Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gt
string<date>

Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gte
string<date>

Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_lt
string<date>

Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_lte
string<date>

Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.

isin
string

The ISIN (International Securities Identification Number) of a non-US listing. An alternative to ticker and market.

limit
integer<int32>

The maximum number of financial statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

market
enum<string>

The market the company is listed in: US (the default), UK or FR. Any ticker of the company, including a second share class, returns the company's statements.

Available options:
US,
UK,
FR
period
enum<string>
required

The time period of the financial statements.

Available options:
annual,
quarterly,
ttm
report_period
string<date>

Filter by exact report period date in YYYY-MM-DD format.

report_period_gt
string<date>

Filter by report period greater than date in YYYY-MM-DD format.

report_period_gte
string<date>

Filter by report period greater than or equal to date in YYYY-MM-DD format.

report_period_lt
string<date>

Filter by report period less than date in YYYY-MM-DD format.

report_period_lte
string<date>

Filter by report period less than or equal to date in YYYY-MM-DD format.

ticker
string

The ticker symbol. Required if cik or isin is not provided.

Response

Financial statements response

financials
object
next_page_url
string

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.