Home › Forums › The XBRL API › Normalized data presentation
- This topic has 0 replies, 1 voice, and was last updated 6 months, 3 weeks ago by David Tauriello.
-
AuthorPosts
-
-
Thursday, May 15, 2025 at 7:40 AM #292244David TaurielloKeymaster
A non-member writes –
I have executed the sample code in your google colab notebook (https://xbrl.us/why-normalize-data), and got a .json file as output. Now my question: How do I identify which objects belong to the balance sheet and which to the income statement? Is there also a way to identify the order of these elements (revenue at the top, net income at the bottom, etc.)? I saw that there are some flags (AssetBalanceFlag), but I could not really figure out how to use them to identify asset items?
The XUSSS Taxonomy’s presentation linkbase is the place to find the hierarchical structure for the data. In XBRL, the data file is often called an instance document, and it contains references to the taxonomy schema file(s) that are to be used to understand the report. Thinking conceptually, the normalized data output from our example is like an e-filed IRS 1040 (which is for individual income taxes in the United States, it’s not in XBRL but should be) … the form was presented for you to enter your numbers, but when you transmit, store or retrieve the data, that’s all you need because the underlying taxonomy is agreed upon and understood unambiguously.
We’ve loaded the XUSSS in our Public filings database; here’s the query for the presentation hierarchy:
https://api.xbrl.us/api/v1/relationship/search?dts.id=928097&network.link-name=presentationLink&fields=network.role-description.sort(ASC),relationship.tree-sequence.sort(ASC),relationship.order.sort(ASC),relationship.tree-depth,relationship.target-nameYou can also get this in a spreadsheet by using an XBRL processor (like Arelle) and opening the entry point for the taxonomy (
https://taxonomies.xbrl.us/standardized-statements/xusss.xsd)
-
-
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 5 months, 2 weeks ago
-
Income Statement data for a company 5 months, 2 weeks ago
-
Using the offset parameter 9 months, 3 weeks ago
-
Using the offset parameter 9 months, 3 weeks ago
-
Using the offset parameter 9 months, 3 weeks 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.





