Search TagniFi Footnotes
Description
Searches for footnote value(s) for specific fiscal periods (annual, quarter or year_to_date). It also supports the ability to find footnotes for multiple periods and statements.
Endpoint
https://api.tagnifi.com/footnotes
Request Parameters
| Attribute | Description | Type | Required? | Default | Notes |
| company | The company's ID or ticker symbol. | String | Yes | Please use our Coverage List to search for companies with data available. | |
| tag | Returns data for a specific tag. | String | No | Please see TagniFi Footnotes Definitions for a list of available tags. | |
| statement | Returns all tags in the selected footnotes statement. | String | No | |
See statement list. |
| period_type | The type of period to search. Valid periods include annual, quarter, or year_to_date. | String | No | annual | |
| fiscal_year | The fiscal year of the period you are requesting. | Number | No | Latest reported fiscal year | |
| fiscal_quarter | The fiscal quarter of the period you are requesting. | Number | No | 4 | This attribute is ignored if annual is specified for the period_type. |
| relative_period | Returns data relative to the most recent data available. For example, 0 returns the most recent data available. | Number | No | 0 (most recent period) | All periods returned are relative to the specified fiscal_year and fiscal_quarter and their associated defaults. |
| vintage_date | Point-in-time date used for back-testing, the Vintage Date will restrict the data for the selected period to use only data filed on or before the selected date. | Date (ISO-8601) | No | Current date | This date must be given in ISO-8601 date only format. Ex. 2013-03-01 |
| industry_template | The industry template for the data you are requesting. | String | No | Commercial | Possible values: commercial or banking |
| offset | The number of rows to skip for a page of fundamentals. | Number | No | 0 | |
| limit | The number of values to return for a page of footnotes. | Number | No | 1 | The maximum limit amount is 25. |
How do I search for a specific tag?
Here is an example request for Caterpillar's building and improvements for fiscal 2016:
https://api.tagnifi.com/footnotes?company=cat&tag=BuildingImprovements&period_type=annual&fiscal_year=2016
Here is the response:
{
"meta": {
"copyright": "TagniFi, LLC. 2015-2017"
},
"footnotes": [
{
"filing_type": "10-K",
"shares_outstanding": 586486024,
"shares_outstanding_date": "2016-12-31",
"filing_link": "http://www.sec.gov/Archives/edgar/data/18230/000001823017000041/0000018230-17-000041-index.htm",
"statement": "property_plant_equipment_section",
"reported_date": "2017-02-15",
"reported_time": "2017-02-15T18:45:35.0000000+00:00",
"start_period": "2016-12-31",
"end_period": "2016-12-31",
"fiscal_year": 2016,
"fiscal_quarter": 4,
"annual_period": true,
"quarter_period": true,
"year_to_date_period": false,
"trailing_twelve_month_period": false,
"industry_template": "commercial",
"company": {
"name": "CATERPILLAR INC",
"id": "US0000018230",
"ticker": "CAT"
},
"tags": [
{
"name": "Building and Improvements",
"tag": "buildingimprovements",
"value": 7383000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 7383000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:LandBuildingsAndImprovementsMember"
}
]
}
]
}
]
}
]
}
How do I return data for an entire footnotes statement?
Here is an example request for Caterpillar's property, plant and equipment statement for fiscal 2016:
https://api.tagnifi.com/footnotes?company=cat&statement=property_plant_equipment_section&period_type=annual&fiscal_year=2016
Here is the response:
{
"meta": {
"copyright": "TagniFi, LLC. 2015-2017"
},
"footnotes": [
{
"filing_type": "10-K",
"shares_outstanding": 586486024,
"shares_outstanding_date": "2016-12-31",
"filing_link": "http://www.sec.gov/Archives/edgar/data/18230/000001823017000041/0000018230-17-000041-index.htm",
"statement": "property_plant_equipment_section",
"reported_date": "2017-02-15",
"reported_time": "2017-02-15T18:45:35.0000000+00:00",
"start_period": "2016-12-31",
"end_period": "2016-12-31",
"fiscal_year": 2016,
"fiscal_quarter": 4,
"annual_period": true,
"quarter_period": true,
"year_to_date_period": false,
"trailing_twelve_month_period": false,
"industry_template": "commercial",
"company": {
"name": "CATERPILLAR INC",
"id": "US0000018230",
"ticker": "CAT"
},
"tags": [
{
"name": "Accumulated Depreciation",
"tag": "accumulateddepreciation",
"value": -16618000000,
"transparencies": [
{
"name": "AccumulatedDepreciationDepletionAndAmortizationPropertyPlantAndEquipment",
"value": -16618000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Less: Accumulated depreciation",
"xbrl_unit": "usd",
"xbrl_domain": []
}
]
},
{
"name": "Building and Improvements",
"tag": "buildingimprovements",
"value": 7383000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 7383000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:LandBuildingsAndImprovementsMember"
}
]
}
]
},
{
"name": "Capitalized Computer Software",
"tag": "capitalizedcomputersoftware",
"value": 1641000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 1641000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:SoftwareAndSoftwareDevelopmentCostsMember"
}
]
}
]
},
{
"name": "Construction In Progress",
"tag": "constructioninprogress",
"value": 771000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 771000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:ConstructionInProgressMember"
}
]
}
]
},
{
"name": "Land",
"tag": "land",
"value": 667000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 667000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:LandMember"
}
]
}
]
},
{
"name": "Machinery, Furniture and Equipment",
"tag": "machineryfurnitureequipment",
"value": 15392000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 15392000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:MachineryAndEquipmentMember"
}
]
}
]
},
{
"name": "Other Property, Plant and Equipment",
"tag": "otherpropertyplantequipment",
"value": 6086000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentGross",
"value": 6086000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Total property, plant and equipment, at cost",
"xbrl_unit": "usd",
"xbrl_domain": [
{
"dimension": "us-gaap:PropertyPlantAndEquipmentByTypeAxis",
"member": "us-gaap:EquipmentLeasedToOtherPartyMember"
}
]
}
]
},
{
"name": "Property, Plant and Equipment, Gross",
"tag": "propertyplantequipmentgross",
"value": 31940000000,
"transparencies": [
{
"name": "Land",
"value": 667000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Building and Improvements",
"value": 7383000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Machinery, Furniture and Equipment",
"value": 15392000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Capitalized Computer Software",
"value": 1641000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Construction In Progress",
"value": 771000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Other Property, Plant and Equipment",
"value": 6086000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
}
]
},
{
"name": "Property, Plant and Equipment, Net",
"tag": "propertyplantequipmentnet",
"value": 15322000000,
"transparencies": [
{
"name": "Property, Plant and Equipment, Gross",
"value": 31940000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
},
{
"name": "Accumulated Depreciation",
"value": -16618000000,
"operator": "+",
"source": "tagnifi_fundamentals",
"xbrl_label": "",
"xbrl_unit": null,
"xbrl_domain": []
}
]
},
{
"name": "Property, Plant and Equipment, Net, As Reported",
"tag": "propertyplantequipmentnetasreported",
"value": 15322000000,
"transparencies": [
{
"name": "PropertyPlantAndEquipmentNet",
"value": 15322000000,
"operator": "+",
"source": "xbrl_usgaap",
"xbrl_label": "Property, plant and equipment - net",
"xbrl_unit": "usd",
"xbrl_domain": []
}
]
}
]
}
]
}