get_submissions#

async AsyncAPI.get_submissions(ticker=None, central_index_key=None)#

Get a submission history.

Retrieve a company’s submission history from the SEC EDGAR database.

Parameters:

  • ticker (str, optional) – The ticker symbol of the company. If provided, the CIK will be derived from the ticker.

  • central_index_key (str, optional) – 10-digit Central Index Key (CIK) of the entity, including leading zeros. A CIK may be obtained at the SEC’s CIK lookup: https://www.sec.gov/search-filings/cik-lookup

Returns:

An object containing the entity’s filing history, including company information and recent filings.

Return type:

SubmissionHistory

Raises:

ValueError – If the request fails or the response is not valid JSON format.

Example

>>> import edgar_sec as ed
>>> import asyncio
>>> async def main():
>>>     api = ed.EdgarAPI().Async
>>>     apple_history = await api.get_submissions("AAPL")
>>>     print(apple_history.name)
>>> asyncio.run(main())
'Apple Inc.'

Note

This endpoint returns the most recent 1,000 filings or at least one year’s worth, whichever is more. For entities with additional filings, the response includes references to additional JSON files and their date ranges.