# Notes & Disclosures

`GET /v1/notes/{ticker}`

Footnote disclosures from dimensional XBRL.

Returns note-level disclosures — revenue disaggregation, inventory components, PPE, goodwill, debt schedules, and leases — as-reported from dimensional XBRL, grouped into sections.

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 |
| --- | --- | --- | --- | --- |
| `period` | string (annual \\| quarterly) | no | `annual` | Reporting frequency. |

## Request

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

## Response

`200 OK` · `application/json`

| Attribute | Type | Description |
| --- | --- | --- |
| `data.sections[]` | object[] | Disclosure sections: { key, title, columns[], rows[] }. |
| `data.sections[].rows[]` | object[] | Line items: { label, values[], is_subtotal, tag }. |

## Example response

```json
{
  "data": {
    "sections": [
      {
        "key": "inventory",
        "title": "Inventory",
        "columns": [
          {
            "period_end": "2025-09-30",
            "label": "FY 2025"
          }
        ],
        "rows": [
          {
            "label": "Finished goods",
            "values": [
              3200000000
            ],
            "is_subtotal": false,
            "tag": "us-gaap:InventoryFinishedGoods"
          }
        ]
      }
    ]
  },
  "meta": {
    "ticker": "AAPL",
    "source": "SEC XBRL (dimensional, 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).
