shopify visitor statistics

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": []
                        }
                    ]
                }
            ]
        }
    ]
}

Still need help? Contact Us Contact Us