Get One Metric's Reported Series
get_conceptThe reported time series for a single normalized metric from one company's XBRL facts — every revenue, net_income or assets observation the filer has published, each with its value, unit, period start and end, and the filing it came from. Use it when a question is about the history, trend or growth of one figure rather than a whole statement, or when you must reconcile a number against the filing it was tagged in. Returns the observations newest first alongside the upstream tag and taxonomy that actually resolved, which matters because filers tag the same economic concept differently and a series cannot be compared across companies without knowing which tag answered. See /.well-known/x402 for current pricing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many observations to return, newest first. Accepts 1 to 200; defaults to 20 when omitted. A decade of annual history needs about 10. | |
| metric | No | Normalized metric key to fetch, exactly as published by list_metrics — for instance revenue, net_income, assets, equity or operating_cash_flow. Call list_metrics first if unsure; a key outside that vocabulary is rejected. | |
| ticker | Yes | Exchange ticker symbol of a single SEC filer, case-insensitive, such as AAPL, MSFT or KO. | |
| taxonomy | No | XBRL taxonomy the resolved tag is drawn from: 'us-gaap' for financial statement concepts, 'dei' for entity-level facts such as shares outstanding. Defaults to 'us-gaap'. | us-gaap |