> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-filings>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-filings.mdx>

---

# Yahoo Finance Filings API

SEC forms from two surfaces, with EDGAR links and exhibits.

`GET /v1/yahoo-finance/instruments/{symbol}/filings` returns `data.filings` and `data.reports`. The filings list carries fields such as `type`, `title`, `date` and `edgarUrl`. The reports list is the SEC report list and carries `type`, `title`, `filingDate`, `formType`, `edgarUrl` and `exhibits`.

`data.sources` reports which parts are available, so a found ticker with an empty report list is visible. Both lists can be empty for an instrument that does not file with the SEC; that stays `lookupStatus: found` with `data.sources.filings: empty`. An unknown ticker returns `lookupStatus: not_found`. Read the exhibits when you need the documents attached to a filing.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/filings`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/filings/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## FAQ

### What is the difference between filings and reports?

filings is the quote-summary list of filings with dates and EDGAR links. reports is the SEC report list, which also carries exhibits. Both can be returned for the same ticker.

### Are the documents included?

The routes return metadata and links, including edgarUrl. The filing exhibit list carries the attached exhibit records; the document bodies are not copied.

### Why is a list empty?

The instrument may not file with the SEC, or that part may be temporarily unavailable. data.sources tells you which optional parts are available.

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.