Search TagniFi Fundamentals
Description
Searches for fundamental value(s) for specific fiscal periods (annual, quarter, year_to_date, or trailing_twelve_month). It also supports the ability to find fundamentals for multiple periods and statements.
Endpoint
https://api.tagnifi.com/fundamentals
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 Fundamentals Definitions for a list of available tags. | |
| statement | Returns all tags in the selected financial statement. | String | No | Possible values: balance_sheet_statement, income_statement, or cash_flow_statement. | |
| period_type | The type of period to search. Valid periods include annual, quarter, year_to_date, or trailing_twelve_month. | 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 fundamentals. | Number | No | 1 | The maximum limit amount is 25. |
How do I search for a specific tag?
Here is an example request for Apple's revenue Q3 of fiscal 2014:
https://api.tagnifi.com/fundamentals?company=aapl&tag=revenue&period_type=quarter&fiscal_year=2014&fiscal_quarter=3
Here is the response:
{
"meta": {
"copyright": "TagniFi, LLC. 2015"
},
"fundamentals": [
{
"filing_type": "10-Q",
"filing_link": "http://www.sec.gov/Archives/edgar/data/320193/000119312514277160/0001193125-14-277160-index.htm",
"statement": "income_statement",
"reported_date": "2014-07-23",
"start_period": "2014-03-30",
"end_period": "2014-06-28",
"fiscal_year": 2014,
"fiscal_quarter": 3,
"company": {
"name": "Apple Inc",
"id": "US0000320193",
"ticker": "AAPL"
},
"tags": [
{
"name": "Operating Revenue",
"tag": "revenue",
"value": 37432000000,
"transparencies": [
{
"name": "SalesRevenueNet",
"value": 37432000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
}
]
}
]
}
How do I return data for an entire financial statement?
Here is an example request for Apple's income statement for Q3 of fiscal 2014:
https://api.tagnifi.com/fundamentals?company=aapl&statement=income_statement&period_type=quarter&fiscal_year=2014&fiscal_quarter=3
Here is the response:
{
"meta": {
"copyright": "TagniFi, LLC. 2015"
},
"fundamentals": [
{
"filing_type": "10-Q",
"filing_link": "http://www.sec.gov/Archives/edgar/data/320193/000119312514277160/0001193125-14-277160-index.htm",
"statement": "income_statement",
"reported_date": "2014-07-23",
"start_period": "2014-03-30",
"end_period": "2014-06-28",
"fiscal_year": 2014,
"fiscal_quarter": 3,
"company": {
"name": "Apple Inc",
"id": "US0000320193",
"ticker": "AAPL"
},
"tags": [
{
"name": "Net Income (Loss) Attributable to Common Shareholders, As Reported",
"tag": "netincomelossattributablecommonshareholdersasreported",
"value": 7748000000,
"transparencies": [
{
"name": "NetIncomeLoss",
"value": 7748000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Diluted Shares Outstanding",
"tag": "dilutedsharesoutstanding",
"value": 6051711000,
"transparencies": [
{
"name": "WeightedAverageNumberOfDilutedSharesOutstanding",
"value": 6051711000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Income Before Income Taxes",
"tag": "incomebeforeincometaxes",
"value": 10484000000,
"transparencies": [
{
"name": "Operating Income",
"value": 10282000000,
"operator": "+",
"source": "tagnifi_fundamentals"
},
{
"name": "Total Other Income (Expense)",
"value": 202000000,
"operator": "+",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Diluted Earnings Per Share, As Reported",
"tag": "dilutedearningspershare",
"value": 1.28,
"transparencies": [
{
"name": "EarningsPerShareDiluted",
"value": 1.28,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Gross Profit, As Reported",
"tag": "grossprofitasreported",
"value": 14735000000,
"transparencies": [
{
"name": "GrossProfit",
"value": 14735000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Total Operating Expenses",
"tag": "totaloperatingexpenses",
"value": 4453000000,
"transparencies": [
{
"name": "Selling, General and Administrative",
"value": 2850000000,
"operator": "+",
"source": "tagnifi_fundamentals"
},
{
"name": "Research and Development",
"value": 1603000000,
"operator": "+",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Research and Development",
"tag": "researchdevelopment",
"value": 1603000000,
"transparencies": [
{
"name": "ResearchAndDevelopmentExpense",
"value": 1603000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Operating Revenue",
"tag": "revenue",
"value": 37432000000,
"transparencies": [
{
"name": "SalesRevenueNet",
"value": 37432000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Operating Income, As Reported",
"tag": "operatingincomeasreported",
"value": 10282000000,
"transparencies": [
{
"name": "OperatingIncomeLoss",
"value": 10282000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Income Taxes",
"tag": "incometaxes",
"value": 2736000000,
"transparencies": [
{
"name": "IncomeTaxExpenseBenefit",
"value": 2736000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Basic Shares Outstanding",
"tag": "basicsharesoutstanding",
"value": 6012635000,
"transparencies": [
{
"name": "WeightedAverageNumberOfSharesOutstandingBasic",
"value": 6012635000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Net Income (Loss) Attributable to Common Shareholders, Basic",
"tag": "netincomelossattributablecommonshareholders",
"value": 7748000000,
"transparencies": [
{
"name": "Consolidated Net Income (Loss)",
"value": 7748000000,
"operator": "+",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Other Income (Expense)",
"tag": "otherexpenseincome",
"value": 202000000,
"transparencies": [
{
"name": "NonoperatingIncomeExpense",
"value": 202000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Income Before Taxes, As Reported",
"tag": "incomebeforetaxesasreported",
"value": 10484000000,
"transparencies": [
{
"name": "IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest",
"value": 10484000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Total Other Income (Expense)",
"tag": "totalotherincomeexpense",
"value": 202000000,
"transparencies": [
{
"name": "Other Income (Expense)",
"value": 202000000,
"operator": "+",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Gross Profit",
"tag": "grossprofit",
"value": 14735000000,
"transparencies": [
{
"name": "Operating Revenue",
"value": 37432000000,
"operator": "+",
"source": "tagnifi_fundamentals"
},
{
"name": "Cost of Revenue",
"value": 22697000000,
"operator": "-",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Selling, General and Administrative",
"tag": "sellinggeneraladministrative",
"value": 2850000000,
"transparencies": [
{
"name": "SellingGeneralAndAdministrativeExpense",
"value": 2850000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Total Operating Expenses, As Reported",
"tag": "totaloperatingexpensesasreported",
"value": 4453000000,
"transparencies": [
{
"name": "OperatingExpenses",
"value": 4453000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Basic Earnings Per Share, As Reported",
"tag": "basicearningspershare",
"value": 1.29,
"transparencies": [
{
"name": "EarningsPerShareBasic",
"value": 1.29,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Net Income (Loss) Attributable to Common Shareholders, Diluted",
"tag": "netincomelossattributablecommonshareholdersdiluted",
"value": 7748000000,
"transparencies": [
{
"name": "Net Income (Loss) Attributable to Common Shareholders, Basic",
"value": 7748000000,
"operator": "+",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Consolidated Net Income (Loss)",
"tag": "consolidatednetincomeloss",
"value": 7748000000,
"transparencies": [
{
"name": "Income Before Income Taxes",
"value": 10484000000,
"operator": "+",
"source": "tagnifi_fundamentals"
},
{
"name": "Income Taxes",
"value": 2736000000,
"operator": "-",
"source": "tagnifi_fundamentals"
}
]
},
{
"name": "Common Stock Dividends Declared",
"tag": "commonstockdividendsdeclared",
"value": 0.47,
"transparencies": [
{
"name": "CommonStockDividendsPerShareDeclared",
"value": 0.47,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Cost of Revenue",
"tag": "costofrevenue",
"value": 22697000000,
"transparencies": [
{
"name": "CostOfGoodsAndServicesSold",
"value": 22697000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
},
{
"name": "Operating Income",
"tag": "operatingincome",
"value": 10282000000,
"transparencies": [
{
"name": "Gross Profit",
"value": 14735000000,
"operator": "+",
"source": "tagnifi_fundamentals"
},
{
"name": "Total Operating Expenses",
"value": 4453000000,
"operator": "-",
"source": "tagnifi_fundamentals"
}
]
}
]
}
]
}
How do I return data for multiple periods?
Here is an example request for Apple's revenue for fiscal 2014 and the preceding two years:
https://api.tagnifi.com/fundamentals?company=aapl&tag=revenue&period_type=annual&fiscal_year=2014&limit=3
Here is the response:
{
"meta": {
"copyright": "TagniFi, LLC. 2015"
},
"fundamentals": [
{
"filing_type": "10-K",
"filing_link": "http://www.sec.gov/Archives/edgar/data/320193/000119312514383437/0001193125-14-383437-index.htm",
"statement": "income_statement",
"reported_date": "2014-10-27",
"start_period": "2013-09-29",
"end_period": "2014-09-27",
"fiscal_year": 2014,
"fiscal_quarter": 4,
"company": {
"name": "Apple Inc",
"id": "US0000320193",
"ticker": "AAPL"
},
"tags": [
{
"name": "Operating Revenue",
"tag": "revenue",
"value": 182795000000,
"transparencies": [
{
"name": "SalesRevenueNet",
"value": 182795000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
}
]
},
{
"filing_type": "10-K",
"filing_link": "http://www.sec.gov/Archives/edgar/data/320193/000119312514383437/0001193125-14-383437-index.htm",
"statement": "income_statement",
"reported_date": "2014-10-27",
"start_period": "2012-09-30",
"end_period": "2013-09-28",
"fiscal_year": 2013,
"fiscal_quarter": 4,
"company": {
"name": "Apple Inc",
"id": "US0000320193",
"ticker": "AAPL"
},
"tags": [
{
"name": "Operating Revenue",
"tag": "revenue",
"value": 170910000000,
"transparencies": [
{
"name": "SalesRevenueNet",
"value": 170910000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
}
]
},
{
"filing_type": "10-K",
"filing_link": "http://www.sec.gov/Archives/edgar/data/320193/000119312514383437/0001193125-14-383437-index.htm",
"statement": "income_statement",
"reported_date": "2014-10-27",
"start_period": "2011-09-25",
"end_period": "2012-09-29",
"fiscal_year": 2012,
"fiscal_quarter": 4,
"company": {
"name": "Apple Inc",
"id": "US0000320193",
"ticker": "AAPL"
},
"tags": [
{
"name": "Operating Revenue",
"tag": "revenue",
"value": 156508000000,
"transparencies": [
{
"name": "SalesRevenueNet",
"value": 156508000000,
"operator": "+",
"source": "xbrl_usgaap"
}
]
}
]
}
]
}