> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Filing intelligence

> Use derived filing events, comparisons, transcripts, and guidance to prioritize source-document review

Start here to prioritize a filing for review. These outputs are derived from filing material: useful for comparing disclosure, finding an event, or assembling a coverage check, but not a replacement for the filing or transcript supporting a material statement.

## Compare a defined filing pair

```bash theme={null}
curl -sS \
  -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/filings/diff?ticker=AAPL&form=10-K&sections=item_1a_risk_factors,item_7_mdna"
```

`ticker` and `form` are required. When `from` and `to` are omitted, the route compares the latest filing with the prior filing of that form. Supply accession numbers or ISO dates for an explicit pair, and record both filing identities, section keys, source URLs, provenance, and `requestId` with the result.

## Routes for derived review signals

| Method | Path                                                             | Job                                                           | Output                                |
| ------ | ---------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------- |
| `GET`  | [`/v1/filings/diff`](/api-reference/filings/get-v1-filings-diff) | Compare sections for one issuer and form.                     | A section-level filing comparison.    |
| `GET`  | [`/v1/filings/events`](/api-reference/filings)                   | Find persisted filing-event rows.                             | Filterable derived event records.     |
| `GET`  | [`/v1/filings/transcripts`](/api-reference/filings)              | Locate qualifying earnings-material transcripts.              | Transcript rows with filing identity. |
| `GET`  | [`/v1/filings/guidance`](/api-reference/filings)                 | Review structured guidance from qualifying earnings material. | Guidance rows with source context.    |
| `GET`  | [`/v1/intelligence/coverage`](/api-reference/intelligence)       | Check an issuer's persisted filing-intelligence coverage.     | An issuer coverage rollup.            |

## Coverage, freshness, and source handling

Events, transcript rows, guidance rows, and diffs point to evidence; they do not establish legal, accounting, or investment conclusions. Transcript and guidance coverage is limited to qualifying earnings materials, so an absent row does not establish that a call or guidance statement did not exist. A diff describes only the selected pair and sections.

These routes can return `404` when the filing-intelligence plane is unavailable. Treat that as availability, not an empty result. Preserve any returned freshness or materialization fields, then retrieve the cited filing before quoting a passage or presenting a conclusion.

## Next action

Fetch the named filing or section for each selected signal and read the source text in its filing-period context.

* [Filings API reference](/api-reference/filings)
* [SEC filing search](/products/filing-search)
* [Filing content search](/products/search)