Secedgar Get Snapshot
secedgar_get_snapshotBuild a company financial profile in one call: the latest value of every supported XBRL concept, grouped by statement. Reads the filer's complete companyfacts payload once rather than one request per concept, so it replaces a run of secedgar_get_financials calls when the question is "what do this company's financials look like right now". Values use the same frame dedup and tag priority as secedgar_get_financials, so the two agree for any concept they both cover. Duration concepts (income statement, cash flow, per-share) report their latest full year and latest single quarter; balance-sheet and entity-info concepts report their latest point-in-time value, since that is the only form they are filed in. A concept the filer does not report is listed under gaps with the XBRL tags that were tried — never zero-filled or interpolated. Use secedgar_get_financials for a full time series of one concept, and secedgar_compare_companies to put several companies side by side.
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>"
},
"name": "secedgar_get_snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company | Yes | Ticker symbol (e.g. "AAPL") or CIK number. Ticker is preferred. | |
| taxonomy | No | XBRL taxonomy to resolve concepts under. Every concept is looked up in this one taxonomy, so ifrs-full covers only the concepts with confirmed IFRS tag variants and the rest — including the dei entity-info concepts — come back under gaps. Leave at us-gaap for domestic filers, where each concept uses its own preferred taxonomy. | us-gaap |
| period_type | No | Which duration periods to report per concept: the latest full year, the latest single quarter, or both (default). Balance-sheet and entity-info concepts are point-in-time and always report their latest instant value regardless of this setting. | both |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | No | Resolved CIK, zero-padded to 10 digits. | |
| gaps | No | Concepts with no value for this filer, never zero-filled or interpolated. | |
| error | No | Present when the call failed. Absent on success. | |
| lines | No | Resolved concepts, ordered by statement group then concept name. | |
| caveats | No | Completeness warnings, else empty: quarters missing every recent year (fiscal Q4 appears only in the 10-K) and, prefixed with the concept name, lines stopping 2+ years behind the filer's newest period. | |
| company | No | Resolved entity name (SEC-conformed). | |
| taxonomy | No | Taxonomy the concepts were resolved under, echoed from input. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| period_type | No | Duration periods reported, echoed from input. | |
| concepts_total | No | Concepts in the supported catalog that were attempted. | |
| concepts_resolved | No | Concepts that produced at least one value. |