Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Filings API

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

GET /v1/yahoo-finance/instruments/{symbol}/filings

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Yahoo Finance Filings API 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.

Other Yahoo Finance endpoints