Home › Forums › The XBRL API › Extraction and Interpretation of Operating Lease Data
- This topic has 4 replies, 2 voices, and was last updated 4 years, 7 months ago by Teji Abraham.
-
AuthorPosts
-
-
Tuesday, May 12, 2020 at 2:12 AM #179419Teji AbrahamParticipant
Hi David,
Hope you are keeping well. I had a few questions regarding the extraction and interpretation of Operating Lease related data:
1) Is there possibility of a time delay between the filing of 10-K/10-Q and when Operating Lease data is available on an xbrl-API endpoint. (we encountered this with WMT on the day 10-K was released. When we tried again after a week the data was there).If is a typical occurrence, is there a way by which we can ascertain if the lack of data is bcos of a delay VS the entity not having any Operating Lease disclosure requirement ?
2) In a prior post, you had pointed out about using fact.has-dimensions=false to return non-dimensional values. However, there are cases where setting has-dimensions as false does not return any operating lease related data (for e.g. GM, cik=0001467858). In this context,
– How do we get operating lease related data (OperatingLeaseLiability, OperatingLeaseLiabilityNoncurrent, OperatingLeaseLiabilityCurrent, OperatingLeaseRightOfUseAsset)
– And how do we select the correct dimension for the consolidated lease data for the entity – because some of the above facts return multiple values
– Is there a xbrl document that explains how to interpret the different dimensions for various concepts.3) Are there alternative way of extracting the above op. lease related facts when the entity does not disclose during interim intervals (ie quarterly). For e.g. when we try to extract Op. Lease data for GM for 2020 Q1 – we are not getting any values for OperatingLeaseLiability, OperatingLeaseLiabilityNoncurrent, OperatingLeaseLiabilityCurrent. Not sure if this is another case of a delay OR some other reason.
Thanks much, Teji
-
Tuesday, May 26, 2020 at 12:10 PM #181112David TaurielloKeymaster
Teji – apologies for the delayed response; I hope you are well.
1) there may be occasions where we’re more than a few minutes behind the SEC: the end of filing periods are rich with reports that have grown in complexity because filers are becoming smarter about using XBRL and the SEC has expanded its program to allow more sophisticated configurations. In addition to being copied to our database, each filing scanned with multiple data quality rulesets (see the
/assertion
endpoint).2) can you share the specific
report.id
where this issue is occurring – ? – it would be helpful to know the context for the data in the complete filing3) Have you tried using 1H and Q2, then subtracting to get Q1 – ? (there’s also a 3QCUM fiscal period that you might be able to use to ‘back into’ quarterly values).
-
Wednesday, May 27, 2020 at 2:06 PM #181308Teji AbrahamParticipant
No worries. Thank you David for the response and the clarifications.
1) Sounds good
2) “report.id”: 269648 is an example. There are several others as well but I have not kept track. In this report, only OperatingLeaseLiabilityNoncurrent is returned when specifying fact.has-dimensions=false
To obtain the other Operating Lease facts, we had to set fact.has-dimensions=true3) I haven’t tried 1H and Q2 — but I heard back from investor relations at a couple of companies that starting in 2020 – they have decided to report Op Lease facts in the interim quarters only if there are material changes.
Thanks again. Teji
-
Monday, June 8, 2020 at 5:17 PM #182490David TaurielloKeymaster
Hi Teji –
When you set dimensions to true (or leave the filter off, in the case of GM and the concepts you shared) and include
dimension.local-name
andmember.local-name
in the fields returned, you can learn more about the structure of the OperatingLease facts:https://api.xbrl.us/api/v1/fact/search?entity.cik=0001467858&concept.local-name=OperatingLeaseLiability,OperatingLeaseLiabilityNoncurrent,OperatingLeaseLiability Current,OperatingLeaseRightOfUseAsset&fact.ultimus=true&fields=report.sec-url,entity.name.sort,report.filing-date.sort(DESC),period.fiscal-year.sort(DESC),period.fiscal-period.sort(DESC),concept.local-name,fact.has-dimensions,dimensions.count,dimension.local-name.sort(DESC),member.local-name.sort(DESC),fact.value,fact.ultimus-index,dts.id
If you’re looking for more information, you can use the
relationship
endpoint to learn where in the report the underlying detail for the facts appear in the presentation (network.role-description
):https://api.xbrl.us/api/v1/relationship/search?dts.id=384701,364091,347365,334440,324699& relationship.target-name=MajorPropertyClassAxis,BalanceSheetLocationAxis, VehiclesMember,AccruedLiabilitiesMember,OtherAssetsMember, OtherLiabilitiesMember&network.link-name=presentationLink& fields=dts.id.sort(DESC),relationship.id,relationship.target-name.sort(ASC),network.role-description.sort(ASC), relationship.source-name,relationship.tree-sequence.sort(ASC)
NOTE: if you put the first query above in Google Sheet cell A1 in showData=(), then drop this formula in A22 or lower, it might help to see how these are related.
=showData(CONCATENATE("https://api.xbrl.us/api/v1/relationship/ search?dts.id=", TEXTJOIN(",", TRUE, UNIQUE(A2:A19)) , "&relationship.target-name=", TEXTJOIN(",", TRUE, UNIQUE(H2:H19)), ",", TEXTJOIN(",", TRUE, UNIQUE(I2:I19)), " &network.link-name=presentationLink&fields=dts.id.sort(DESC), relationship.id,relationship.target-name.sort(ASC), network.role-description.sort(ASC),relationship.source-name, relationship.tree-sequence.sort(ASC),concept.local-name"))
This is for demonstration purposes only 🙂 – keep in mind the axis/member relationship of the first query is not preserved in the second, so some of the results in the second may not be appropriate.
-
-
Wednesday, June 17, 2020 at 1:17 AM #183409Teji AbrahamParticipant
Thanks David – much appreciate the clarifications.
Best regards, Teji
-
-
AuthorPosts
- You must be logged in to reply to this topic.
Search Forums
Recent Topics
Recent Replies
-
Spreadsheet Commands: Query Worksheet and Query Workbook Query Workbook 2 months, 3 weeks ago
-
Query for multiple dimensions 4 months, 3 weeks ago
-
Query for multiple dimensions 4 months, 3 weeks ago
-
Showdata function 7 months, 1 week ago
-
Showdata function 7 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.