Skip to main content

filings

Get the URLs to SEC filings reported to EDGAR database, such as 10-K, 10-Q, 8-K, and more.

SEC filings include Form 10-K, Form 10-Q, Form 8-K, the proxy statement, Forms 3, 4, and 5, Schedule 13, Form 114, Foreign Investment Disclosures and others. The annual 10-K report is required to be filed annually and includes the company's financial statements, management discussion and analysis, and audited financial statements.

Examples​

from openbb import obb
obb.equity.discovery.filings(provider='fmp')
# Get filings for the year 2023, limited to 100 results
obb.equity.discovery.filings(start_date='2023-01-01', end_date='2023-12-31', limit=100, provider='fmp')

Parameters​

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

form_type: str
Filter by form type. Visit https://www.sec.gov/forms for a list of supported form types.

limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.

Returns​

results: list[DiscoveryFilings]

Serializable results.

provider: Optional[Literal['fmp']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

Data​

symbol: str
Symbol representing the entity requested in the data.

cik: str
Central Index Key (CIK) for the requested entity.

filing_date: date
The date of the data.

accepted_date: datetime
form_type: str
The form type of the filing

link: str
URL to the filing page on the SEC site.

On this page