---
title: "As-filed XBRL financial facts, each with its accession"
method: GET
path: "/companies/{ticker}/financials"
tags: ["filings"]
---

# As-filed XBRL financial facts, each with its accession

`GET /companies/{ticker}/financials`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/companies/{ticker}/financials`
- Auth: HTTP bearer

Financial facts exactly as one filing stated them, each value with the accession number, form, filing date, period start and end, period kind and the sec.gov URL of the filing it came from. Facts are XBRL only and pass Kresmion's servable rule (no unscaled prose numbers). `value` is the full fiscal year on an annual form and YEAR-TO-DATE on a 10-Q (read `period_kind`: FY, YTD, Q, TTM, instant); `quarter_value` is the three months the filer tagged beside it. Nothing is derived: no Q4 from a full year minus nine months. `latest_per_period=true` (default) keeps the latest filing per metric and period, so an amendment replaces the original; set false for every filing that stated the period. `metric` takes up to 12 comma-separated names (default: revenue, gross_profit, operating_income, net_income, eps_diluted, total_assets, total_liabilities, stockholders_equity, cash, operating_cash_flow, capex). `unit` is abs (an amount in `currency`), per_share, shares or pure (a fraction: 0.046 = 4.6%). A null currency means not established, never dollars. An absent metric means not established for this company, listed in `meta.metrics_without_values`.

## Path parameters

- `ticker` string, required: Ticker (NVDA), a former ticker (BK resolves to BNY; a closed company resolves to its <T>.D row), or a CIK.

## Query parameters

- `metric` string, nullable: Comma-separated metric names (see the description).
- `period` string: annual = facts from 10-K/20-F/40-F; quarterly = facts from 10-Q; all = both.
- `since` string, date, nullable: Only facts whose period ends on or after this date.
- `latest_per_period` boolean
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kresmion/apis/kresmion-api.md) · [All operations](https://skmtc.dev/kresmion/apis/kresmion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kresmion/apis/kresmion-api/revisions/a94962dddccb?raw)