/metric/filings

List filings for a ticker that have metrics available, returning one row per filing with identifiers you use as metric_group_id on other metric routes.

POST/api/v1/metric/filings

Credits10Rate limit100 per minute

Request:

tickerstringrequired

1–32 characters.

fiscal_yearintegerconditional

1990–2100. You must supply fiscal_year or as_of_date (YYYY-MM-DD).

form_typesarray of string

Max 8 entries; each max 32 characters.

quarterstring

Max 4 characters.

as_of_datestring

YYYY-MM-DD: exclude filings filed after this date.

Response:

credits_used

Always 10 when successful.

fiscal_year

Echo of request.

as_of_date

Echo of request.

company

Company profile (ticker, jurisdiction, cik, legal_name) or null.

metric_groups

Array of objects; each includes metric_group_id, filing identity fields, dates, reporting currency, and optional amendment flags.

form_types, quarter

Present only if you sent them in the request.

_warnings

Optional; present when dates exclude all rows.

Errors:

HTTP	`error_code`	When
400	`METRICS_UNSUPPORTED_FOR_KR`, `_JP`, `_EU`, `_CN`	Computed metrics are available for US (SEC) companies; the ticker is a Korean, Japanese, European or China A-share company (not charged).
403	`PLAN_TIER_INSUFFICIENT_COVERAGE`	The company is outside your plan's coverage scope. Still debits 10 credits.
402	`CREDITS_INSUFFICIENT`	Insufficient credits.
422	—	Validation (e.g. neither `fiscal_year` nor `as_of_date`).