get_company_concept#

async AsyncAPI.get_company_concept(taxonomy, tag, ticker=None, central_index_key=None)#

Get a company concept.

Retrieve XBRL disclosures for a specific concept from a company.

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

  • taxonomy (str) – A non-custom taxonomy identifier (e.g. ‘us-gaap’, ‘ifrs-full’, ‘dei’, or ‘srt’).

  • tag (str) – The specific disclosure concept tag to retrieve, such as ‘AccountsPayableCurrent’ or ‘Assets’.

Returns:

An object containing all disclosures related to the specified concept, organized by units of measure.

Return type:

CompanyConcept

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()
>>>     # Get Apple Inc's Accounts Payable disclosure asynchronously
>>>     concept = await api.Async.get_company_concept("us-gaap", "AccountsPayableCurrent", "AAPL")
>>>     for unit in concept.units:
>>>         print(f"Value: {unit.val}, Period: {unit.end}")
>>> asyncio.run(main())

Note

This endpoint returns separate arrays of facts for each unit of measure that the company has disclosed (e.g., values reported in both USD and EUR).