# Financial Statement

`GET /v1/statements/{ticker}`

As-published income statement, balance sheet, or cash flow.

Returns a financial statement as a row schema, period columns, and a sparse value grid. Values are taken from the SEC-rendered statement of each filing exactly as published: signs follow the printed statement (deductions negative), and each period reflects the NEWEST filing that reports it, so restated comparatives supersede originally-reported figures. Set provenance=1 to attach per-cell SEC filing attribution — every number traces back to the filing that published it.

Authentication: `Authorization: Bearer <API key>`. As-reported SEC fundamentals, quotes, valuation and screener.

## Path parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `ticker` | string | yes | — | US-listed ticker symbol (1–12 characters, case-insensitive). |

## Query parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `type` | string (income \\| balance \\| cash) | no | `income` | Which statement to return. |
| `provenance` | string (1) | no | — | Set to "1" to include per-cell SEC filing attribution. |

## Request

```bash
curl "https://app.akyla.ai/v1/statements/AAPL" \
  -H "Authorization: Bearer $AKYLA_API_KEY"
```

## Response

`200 OK` · `application/json`

| Attribute | Type | Description |
| --- | --- | --- |
| `data.statement` | string | Resolved statement type (income_stmt \| balance_sheet \| cash_flow). |
| `data.cik` | string | SEC Central Index Key. |
| `data.currency` | string | Reporting currency (ISO-4217, e.g. 'CAD'); null means USD. |
| `data.schema[]` | object[] | Row definitions: { label, tag, indent, is_subtotal, sig }. |
| `data.columns[]` | object[] | Period columns: { key, period_end, duration, label }. |
| `data.grid` | object | grid[rowSig][columnKey] = numeric value. |
| `data.provenance` | object | Present only with provenance=1; per-cell filing source. |

## Example response

```json
{
  "data": {
    "ticker": "AAPL",
    "statement": "income_stmt",
    "cik": "0000320193",
    "schema": [
      {
        "label": "Revenue",
        "tag": "us-gaap:Revenues",
        "indent": 0,
        "is_subtotal": false,
        "sig": "S:rev|L:revenue"
      }
    ],
    "columns": [
      {
        "key": "2026-03-31|3|Q2",
        "period_end": "2026-03-31",
        "duration": 3,
        "label": "Q2"
      }
    ],
    "grid": {
      "S:rev|L:revenue": {
        "2026-03-31|3|Q2": 95400000000
      }
    }
  },
  "meta": {
    "ticker": "AAPL",
    "source": "SEC XBRL (as-reported)",
    "api_version": "v1",
    "generated_at": "2026-06-27T15:24:00.000Z"
  }
}
```

Part of the Financial Data API — full reference: https://app.akyla.ai/docs (Markdown: https://app.akyla.ai/docs.md).