/metric/items
Same sourcing as POST /metric/all, but returns only the metric names you list.
Request: Same as POST /metric/all, plus:
metric_namesarray of stringrequired1–100 names from the catalog; each max 256 characters.
detailstringSame as POST /metric/all. See Light and minimal views.
Credits: 158, when at least one name is in the catalog.
Response:
credits_used158.
metric_group_idThe metric group ID actually used.
valuation_contextEcho of flags, formula inputs, and requested metric_names.
ticker, form_type, fiscal_year, quarter, cik, source_accession, primary_document, source_url_prefixFiling identity and SEC base URL. source_url_prefix may be null; combine it with each fact’s source_locator (see below) to build the SEC viewer URL.
price_insensitive_metricsObject containing the requested price-insensitive metrics. Nested fact_refs / components entries with fact_id also expose source_locator (may be null).
price_sensitive_metricsObject containing a filing_date_price + historical pair (the requested price-sensitive metrics computed from the filing-date stock price; historical is {} when none were requested) and, when price-sensitive metrics were requested, a realtime sub-object. The realtime sub-object follows the same convention as POST /metric/all: metric rows when current_price is supplied, { "status": "missing", "hint": "..." } otherwise. Same source_locator convention on nested fact references where fact_id is present.
price_contextPresent whenever the response would include a realtime block (same shape as in POST /metric/all).
segmentsArray of segment data.
ttm_composite, dei_correctedOptional root fields, present when the filing has them.
corporate_actionsOptional root field; same shape and semantics as in POST /metric/all. The same per-metric split variants appear on pe_ratio / dividend_yield / eps_growth_yoy when you request them.
_metric_name_errors, _supported_metric_names, _supported_metric_names_notePresent when some requested names are outside the catalog or not in this filing: one line per such name, plus every supported name.
_warningsOptional; warnings about amendments or formulas.
Errors: Same as POST /metric/all, plus:
| HTTP | error_code | When |
|---|---|---|
| 400 | METRIC_INVALID_METRIC_NAME | No requested name is in the catalog; detail lists every supported name in _supported_metric_names. Not charged. |