Secedgar Get Financials
secedgar_get_financialsGet historical XBRL financial data for a company. Accepts friendly concept names (e.g., "revenue", "net_income", "assets") or raw XBRL tags. Discover available friendly names with secedgar_search_concepts. Handles historical tag changes and deduplicates data automatically. The full series is also staged as df_ when a canvas is available — inspect it with secedgar_dataframe_describe, then analyze it with secedgar_dataframe_query.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "<company>",
"concept": "<concept>"
},
"name": "secedgar_get_financials"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | SEC unit key to read the series in, for a concept reported in more than one (e.g. "ZAR" and a "USD" convenience translation, or "USD/EUR" among exchange-rate pairs). "USD-per-shares" is read as "USD/shares". When omitted, the series takes the unit of its newest value, then the unit with more periods; any other units are named in caveats. | |
| limit | No | Cap the inline data[] to the most-recent N periods (the series is newest-first). The full series is always registered to the dataframe, so older periods stay queryable via secedgar_dataframe_query. Omit to return every period inline. | |
| company | Yes | Ticker symbol (e.g., "AAPL") or CIK number. Ticker is preferred. | |
| concept | Yes | Financial concept — friendly name (e.g., "revenue", "net_income", "assets", "eps_diluted") or raw XBRL tag (e.g., "AccountsPayableCurrent"). Friendly names auto-resolve to the correct XBRL tags and handle historical tag changes. A friendly name matches in any case or separator form, in lowerCamelCase ("operatingIncome"), or spelled from its label ("capital_expenditures" for capex); UpperCamelCase input is always a raw tag. | |
| taxonomy | No | XBRL taxonomy. us-gaap for US companies, ifrs-full for foreign filers, dei for entity info (shares outstanding). | us-gaap |
| period_type | No | Filter to annual (FY) or quarterly (Q1-Q4) data. "all" returns both. For an instant (balance-sheet) concept, "annual" returns the values dated on the filer's fiscal-year ends. When omitted, defaults to "annual", except that an instant concept returns its full series. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| cik | No | Resolved CIK, zero-padded to 10 digits. | |
| data | No | Deduplicated series, newest first, one value per calendar period. A proxy-framed period takes the filer's own report; an annual frame held by a 10-Q trailing-twelve-month figure is left out. An instant's annual values are its fiscal-year-end values (CY2025Q2I for a June year end). | |
| unit | No | Unit of every value in data (e.g., "USD", "USD/shares"): the unit input (an unreported one fails with no_unit_data), else the newest value's unit, then the one with more periods. | |
| error | No | Present when the call failed. Absent on success. | |
| label | No | Human-readable taxonomy label of the concept tag. | |
| shown | No | Number of periods shown inline. | |
| notice | No | Guidance when the inline series was capped, or when the full series is staged as a dataframe. | |
| caveats | No | Completeness warnings, absent when none apply: other units reported, with period counts and spans (pass unit to read one); quarters missing every recent year (fiscal Q4 appears only in the 10-K); a series ending well before today (a retired or dropped tag). | |
| company | No | Resolved entity name (SEC-conformed). | |
| concept | No | XBRL tag behind the newest value; each row names its own tag. | |
| dataset | No | Dataframe of the series: company is entity_name, start/end are period_start/period_end, fiscal keys are source_filing_fy/source_filing_fp; order by period_end. Absent without canvas. | |
| truncated | No | True when the inline data[] was capped by limit. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| tags_tried | No | XBRL tags attempted, when a friendly name maps to several. | |
| description | No | XBRL taxonomy description of the tag. Often absent for extension tags and older concepts. |