---
title: "List annual reports"
method: GET
path: "/v1/annual-reports"
tags: ["Filings"]
---

# List annual reports

`GET /v1/annual-reports`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/annual-reports`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns the canonical annual report (10-K, or 20-F/40-F) for each issuer-year. When an Annual Report to Shareholders (ARS) exists for the same year it is attached as `sibling`. `arsKind` is `unclassified` unless the ARS opening text is available; when it is, the value is one of `tenk_reprint`, `letter_plus_tenk`, or `glossy_other`. PDF primaries are not HTML-rendered: `renderCapability` is `pdf_unrendered` and `documentUrl` points at SEC EDGAR. `letterId` is currently always null. Canonical ticker form is `BRK-B`, not `BRK.B`. Metered as `annual_report_lookup`. See [API conventions](https://docs.secapi.ai/api-conventions).

## Query parameters

- `ticker` string
- `cik` string
- `year` integer
- `limit` integer
- `cursor` integer

## Response `200`

Canonical 10-K/20-F/40-F annual reports with optional ARS siblings.

- AnnualReportList
  - `object` 'list', required
  - `data` object[], required
    - `object` 'annual_report', required
    - `id` string, required
    - `createdAt` string, required
    - `livemode` boolean, required
    - `entityId` string, required
    - `ticker` string, nullable, required
    - `companyName` string, required
    - `cik` string, required
    - `fiscalYear` integer, nullable, required
    - `form` '10-K' | '10-K/A' | '20-F' | '20-F/A' | '40-F' | '40-F/A', required
    - `accessionNumber` string, required
    - `filingDate` string, required
    - `reportDate` string, nullable, required
    - `documentUrl` string, uri, nullable, required
    - `hasLetterExhibit` boolean, required
    - `letterId` string, nullable
    - `sibling` object, nullable, required
      - `form` 'ARS', required
      - `accessionNumber` string, required
      - `filingDate` string, required
      - `documentUrl` string, uri, nullable, required
      - `arsKind` 'tenk_reprint' | 'letter_plus_tenk' | 'glossy_other' | 'unclassified', required
      - `renderCapability` 'html_rendered' | 'pdf_unrendered', required
      - `letterId` string, nullable
    - `provenance` object, required
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `responseMode` 'compact' | 'standard' | 'verbose', nullable
  - `include` string[], nullable
  - `requestId` string, required

## Other responses

- `default`: Contract-aware error response

---

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