Home › Forums › The XBRL API › Get recents fact values
- This topic has 1 reply, 1 voice, and was last updated 4 years, 8 months ago by David Tauriello.
-
AuthorPosts
-
-
Saturday, February 19, 2022 at 7:20 AM #192506AnonymousInactive
Hi David,
Thank you for your assistance here. It really helps to move forward in building the app.
So, I came with question. How to get most recent fat value? I’m trying to use ultimus and ultimus-index, but sometimes I still getting not recent value of report facts.
Here is my path to get fact values.
1. Firstly, of all I’m collecting reports for specific CIK.
2. Secondly, using report.id and api /api/v1/report/{report.id}/fact/search I’m collecting facts of report. Here is my query, I will skip fields part:
10-Qhttps://api.xbrl.us/api/v1/report/333770/fact/search?fact.ultimus=true
10-Khttps://api.xbrl.us/api/v1/report/323207/fact/search?fact.ultimus=true
In these two examples I’m using ultimus, however I’m still getting not recent values and those values also has ultimus-index = 1Is there a better way to get recent fact values for specific report?
How can I get fiscal year for report object, so I can compare report fiscal year and fact fiscal year)Thanks in advance for all answers.
Arthur -
Saturday, February 19, 2022 at 10:57 AM #197963David TaurielloKeymaster
Hi Arthur – first, apologies for the delay in responding – this post was flagged in our system (probably because it includes ‘https://’
The
fact.ultimusparameter is used on the/factendpoint. When you specify a/report, you will return all facts in the report without regard tofact.ultimus.Use your
/reportquery to return thedts.idvalue for the report, then use a separate/factquery to showfact.ultimus-indexdetail./fact/search?dts.id=428275&fact.ultimus=false&fact.has-dimensions=false&fields=entity.id,report.id,concept.local-name,fact.value,fact.ultimus-index,period.fiscal-period,period.fiscal-year.sort(DESC)In the query above, IntangibleAssetsNetExcludingGoodwill for the year 2020 was reported several more times:
/fact/search?entity.id=6252&concept.local-name=IntangibleAssetsNetExcludingGoodwill&fact.has-dimensions=false&period.fiscal-period=Y&period.fiscal-year=2020&fields=concept.local-name,fact.numerical-value,fact.ultimus-index.sort(DESC),report.id,period.fiscal-period,period.fiscal-year
Let me know if you have additional questions about this.
-
-
AuthorPosts
- You must be logged in to reply to this topic.
Search Forums
Recent Topics
Recent Replies
-
Getting started with the XBRL Google Sheet and add-on 3 weeks, 5 days ago
-
Income Statement data for a company 1 year, 4 months ago
-
Income Statement data for a company 1 year, 4 months ago
-
Using the offset parameter 1 year, 8 months ago
-
Using the offset parameter 1 year, 8 months 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
- 2026 US GAAP Taxonomy Viewer
- Live support - Monday, 3:30 - 4:30 PM ET
Who's using this free data?
API Use 2026 || API Use 2025 || 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.





