Home › Forums › The XBRL API › How to get list of Subsidiaries for a company in a filing
- This topic has 4 replies, 2 voices, and was last updated 3 years, 11 months ago by David Tauriello.
-
AuthorPosts
-
-
Tuesday, September 29, 2020 at 9:34 AM #186199Ajit VasudevanParticipant
Hello
I am trying to obtain the list of Subsidiaries for a company from its 10K filing.
For example, Apples 2019 10K filing is athttps://www.sec.gov/Archives/edgar/data/320193/000032019319000119/a10-k20199282019.htm
And from there, you can navigate to the “Subsidiaries of the Registrant” – which is Exhibit 21.1
https://www.sec.gov/Archives/edgar/data/320193/000032019319000119/a10-kexhibit2112019.htm
Any help on what the API query would be to get this info would be great!
Thanks
Aj -
Tuesday, September 29, 2020 at 9:40 AM #186226David TaurielloKeymaster
Hi Ajit – we’re finalizing a /document endpoint with text search capability for XBRL US Members that will allow you to get details like this, which are outside of the XBRL facts for the filing.
Once its ready, we’ll be holding a web meeting to cover the basics of search – wildcard options, etc. – as well as show some other tools for data access.
-
Friday, October 2, 2020 at 12:51 PM #186293Ajit VasudevanParticipant
Thanks David. Do you have an ETA on when this API would be ready?
-
Tuesday, October 6, 2020 at 10:12 AM #186352David TaurielloKeymaster
Ajit – it’s in production now – see the document endpoint here for documentation: https://xbrlus.github.io/xbrl-api and note that we’re making some modifications to the query parameters.
-
Monday, January 17, 2022 at 2:36 PM #196967David TaurielloKeymaster
Hi Ajit – you’ll need two queries to return a list that confirms the text string exists and provides a URL to the HTML in EDGAR. As this content is in the unstructured part of the filing and not tagged, there’s no way for our database to show only the specific detail for the search query.
The first query returns our database’s internal
dts.idvalues for filings that should be searched, and the second query searches for the specified string in the document (excluding XBRL-tagged information) and returns an excerpt and URL for it.Here’s a Jupyter notebook as an example – https://mybinder.org/v2/gh/xbrlus/xbrl-api-ipynb/python?filepath=xbrl_us_api_doctext.ipynb – it may take a few minutes for the environment to get spun up, but after that, scroll to the bottom and you should see several examples for
dts.idvalues selected from the initial query against Apple’s SIC code.If you enter your credentials and follow the instructions, you should be able to get other results. At a minimum, you can copy out the queries and modify them elsewhere as needed.
Post back here and let us know how it works out for you.
Sincerely,
David
-
-
AuthorPosts
- You must be logged in to reply to this topic.
Search Forums
Recent Topics
- Income Statement data for a company by David Tauriello
- Normalized data presentation by David Tauriello
- Extract Director RSUs/Options Form 14A by Priyanka Goonetilleke
- Using the offset parameter by David Tauriello
- Spreadsheet Commands: Query Worksheet and Query Workbook Query Workbook by Liam Noailles
Recent Replies
-
Income Statement data for a company 6 months ago
-
Income Statement data for a company 6 months ago
-
Using the offset parameter 10 months, 1 week ago
-
Using the offset parameter 10 months, 1 week ago
-
Using the offset parameter 10 months, 1 week ago
Documentation & Discussion
- Get started with Google Sheets OR
- Get started with Microsoft Excel OR
- Get access to as-filed data from us for other tools or your own app
- XBRL API Interactive Documentation
- Ten Tips & Techniques
- The XBRL API
- XBRL Data Community
- 2024 US GAAP Taxonomy Viewer
- Live support - Monday, 3:30 - 4:30 PM ET
Who's using this free data?
API Use 2024 || API Use 2023 || API Use 2022 || API Use 2021 || API Use 2020 || API Use 2019 || API Use 2018
Join XBRL US
- Individual Options - Basic, Power User & Sole Practitioner
- For Your Team - Startup, Non-Profit, Academic & Corporate options
- Member Benefits Comparison Table
Using the XBRL API with the Public Filings Database
Unless otherwise agreed to in writing, any and all use of the XBRL API to authenticate and retrieve data from the XBRL US Database of Public Filings implies user consent and agreement with the XBRL US API Agreement. If you are unable to agree to these terms, do not use the XBRL API.
To use the XBRL API outside of Google Sheets, your account needs to be provisioned for OAuth2 access.





