getIncomeStatements API

The getIncomeStatements API provides access to public company financial Income statements based on symbol.

Pricing is based on the number of monthly queries and fields requested. We offer four packages: Small, Medium, Large, Enterprise. Contact us for additional details.


API Documentation

INPUTS:

symbols (required)
A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used. (list)
Example: IBM,AAPL,GOOG

frequency (required)
The frequency of financial statement reporting, either Quarterly ("Quarter") or Annually ("Annual"). (enum)
Valid values: Quarter, Annual
Example: Quarter

count (optional)
The number of Quarterly or Annual periods of financial statements to return. (int)
Default: 1
Example: 1

rawData (optional)
Return raw data, otherwise sales, costs, expenses, tax, and income data is displayed in thousands. (int)
Default: 0
Example: 1


OUTPUTS:

symbol (always returned)
A symbol or code that identifies a financial instrument. (string)
date (always returned)
The date of the financial statement. (date)
sales (always returned)
Total revenue or sales for the Income Statement period. (double)
costGoods (always returned)
The cost of goods sold. (double)
grossProfit (always returned)
Sales less the cost of goods sold. (double)
operatingExpenses (always returned)
Expenses related to operating the business. (double)
operatingIncome (always returned)
Gross profit less operating expenses. (double)
interestExpense (always returned)
The cost incurred by an entity for borrowed funds. (double)
otherIncomeExpenses (always returned)
Income or expenses not related to normal busienss operations. (double)
preTaxIncome (always returned)
Operating income net other income or expenses. (double)
incomeTax (always returned)
The tax on the company's income. (double)
netIncome (always returned)
Net income less all expenses and tax. (double)
basicEpsContOp (always returned)
Income from continuing operations divided by the number of shares outstanding. (double)
basicEpsTotalOp (always returned)
Net income divided by the number of shares outstanding. (double)
dilutedEpsContOp (always returned)
Income from continuing operations divided by the number of diluted shares outstanding. (double)
dilutedEpsTotalOp (always returned)
Net income divided by the number of diluted shares outstanding. (double)
ebitda (always returned)
Earnings before interest, depreciation and ammortization. (double)

STATUS CODE RESPONSES:

200 OK Success
400 Bad Request The request was invalid, please see the message for more information.
500 Internal Server Error Something is not working correctly, please contact support.