/metric/items

Same sourcing as POST /metric/all, but returns only the metric names you list.

POST/api/v1/metric/items
Credits158Rate limit60 per minute

Request: Same as POST /metric/all, plus:

metric_namesarray of stringrequired

1–100 names from the catalog; each max 256 characters.

detailstring

Same as POST /metric/all. See Light and minimal views.

Credits: 158, when at least one name is in the catalog.

Response:

credits_used

158.

metric_group_id

The metric group ID actually used.

valuation_context

Echo of flags, formula inputs, and requested metric_names.

ticker, form_type, fiscal_year, quarter, cik, source_accession, primary_document, source_url_prefix

Filing 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_metrics

Object containing the requested price-insensitive metrics. Nested fact_refs / components entries with fact_id also expose source_locator (may be null).

price_sensitive_metrics

Object 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_context

Present whenever the response would include a realtime block (same shape as in POST /metric/all).

segments

Array of segment data.

ttm_composite, dei_corrected

Optional root fields, present when the filing has them.

corporate_actions

Optional 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_note

Present when some requested names are outside the catalog or not in this filing: one line per such name, plus every supported name.

_warnings

Optional; warnings about amendments or formulas.

Errors: Same as POST /metric/all, plus:

HTTPerror_codeWhen
400METRIC_INVALID_METRIC_NAMENo requested name is in the catalog; detail lists every supported name in _supported_metric_names. Not charged.