API: Return on Invested Capital

The data used to calculate Return on Invested Capital (ROIC), including variant calculations using beginning, ending, year-over-year average, 4-quarter average, gross, and GAAP-data-only invested capital. Updated daily.


For more information about our rating methodology, see the Education section of our website:

API: ROIC: Single Datapoint

Endpoint
URL
Method
/metrics/roic/:ticker
GET
URL Parameters
Name
Description
Example
:ticker
Ticker of the stock. You can use the coverage endpoint to get full lists of options.
A
Query Parameters
Name
Required
Description
Example
:datapoint
Required
Name of data point. Click here for a full list of available data points
NOPAT
:year
Required
Fiscal year of the data point. We generally cover companies back to the first digital document filed with the SEC.
2017
:quarter
Optional
Fiscal quarter Options:
Omit for annual data
1 = Q1 quarterly data
2 = Q2 quarterly data
3 = Q3 quarterly data
4 = Q4 quarterly data
1
:ttm
Optional
Trailing twelve months (TTM) data Options:
Omit for annual data
1 = TTM data ending with Q1 (indicated fiscal year Q1 + prior fiscal year Q4, Q3, & Q2)
2 = TTM data ending with Q2 (indicated fiscal year Q2 & Q1 + prior fiscal year Q4 & Q3)
3 = TTM data ending with Q3 (indicated fiscal year Q3, Q2, & Q1 + prior fiscal year Q4)
4 = TTM data ending with Q4 (indicated fiscal year Q4, Q3, Q2, & Q1).
1
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
year
Fiscal year of the data value.
2017
period
Period of the requested data; 1-4 indicate quarterly or TTM periods and 5 indicates an annual period.
5
periodtype
Period type of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
periodstring
Period string of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
datapoint
Name of data point.
ROIC
datavalue
Value of the requested datapoint in ones.
35490000000.00000000000000000
Sample Call:
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/metrics/roic/AAPL?datapoint=NOPAT&year=2015'
Success Response:

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "NOPAT",
        "datavalue": "35490000000.00000000000000000"
      }
    ]
  }
}
  

API: ROIC: All Datapoints

Endpoint
URL
Method
/metrics/roic/:ticker
GET
URL Parameters
Name
Description
Example
:ticker
Ticker of the stock. You can use the coverage endpoint to get full lists of options.
A
Query Parameters
Name
Required
Description
Example
:year
Required
Fiscal year of the data point. We generally cover companies back to the first digital document filed with the SEC.
2017
:quarter
Optional
Fiscal quarter Options:
Omit for annual data
1 = Q1 quarterly data
2 = Q2 quarterly data
3 = Q3 quarterly data
4 = Q4 quarterly data
1
:ttm
Optional
Trailing twelve months (TTM) data Options:
Omit for annual data
1 = TTM data ending with Q1 (indicated fiscal year Q1 + prior fiscal year Q4, Q3, & Q2)
2 = TTM data ending with Q2 (indicated fiscal year Q2 & Q1 + prior fiscal year Q4 & Q3)
3 = TTM data ending with Q3 (indicated fiscal year Q3, Q2, & Q1 + prior fiscal year Q4)
4 = TTM data ending with Q4 (indicated fiscal year Q4, Q3, Q2, & Q1).
1
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
year
Fiscal year of the data value.
2017
period
Period of the requested data; 1-4 indicate quarterly or TTM periods and 5 indicates an annual period.
5
periodtype
Period type of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
periodstring
Period string of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
datapoint
Name of data point.
ROIC
datavalue
Value of the datapoint in ones.
35490000000.00000000000000000
Sample Call:
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/metrics/roic/AAPL?year=2015'
Success Response:

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "NOPAT",
        "datavalue": "35490000000.00000000000000000"
      },
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "CAPITAL_INVESTED_ADJUSTED",
        "datavalue": "35490000000.00000000000000000"
      },
      ...
    ]
  }
}
  

Datapoints

Name
Description
Datapoint
Invested Capital
Invested capital is the value of the money invested in a business over its lifetime.
CAPITAL_INVESTED
Average Invested Capital
Average Invested Capital over the year, adjusted for acquisitions. The denominator of our ROIC calculation.
CAPITAL_INVESTED_ADJUSTED
Average GAAP-Based Invested Capital
Average Invested Capital calculated based only on reported GAAP data from the financial statements. GAAP-Based Average Invested Capital is what is generally provided by other data providers. This is compared to New Constructs' Average Invested Capital, which is based on critical information from the MD&A and footnotes.
CAPITAL_INVESTED_ADJUSTED_GAAP
Beginning Invested Capital
Invested capital at the beginning of the year.
CAPITAL_INVESTED_BEGINNING
GAAP-Based Invested Capital
Invested Capital calculated based only on reported GAAP data from the financial statements. GAAP-Based Invested Capital is what is generally provided by other data providers. This is compared to New Constructs' Invested Capital, which is based on critical information from the MD&A and footnotes.
CAPITAL_INVESTED_GAAP
Gross Invested Capital
Gross Invested Capital is calculated like our regular Invested Capital calculation, but also includes accumulated depreciation and amortization. We use Average Gross Invested Capital as the denominator in our ROGIC calculation.
CAPITAL_INVESTED_GROSS
Average Gross Invested Capital
Average Gross Invested Capital is calculated like our regular Average Invested Capital calculation, but also includes accumulated depreciation and amortization. We use Average Gross Invested Capital as the denominator in our ROGIC calculation.
CAPITAL_INVESTED_GROSS_ADJUSTED
Average Invested Capital Using Last 4 Quarters
Average invested capital of the last four quarters.
CAPITAL_INVESTED_Q_AVG
Average Invested Capital Using Year-over-Year Data
Average invested capital using the year-over-year period-beginning and -ending values.
CAPITAL_INVESTED_YOY_AVG
NOPAT (Net Operating Profit After Tax)
NOPAT (Net Operating Profit After Tax)
NOPAT
GAAP-Based NOPAT
NOPAT calculated based only on reported GAAP data from the financial statements. GAAP-Based NOPAT is what is generally provided by other data providers. This is compared to New Constructs' NOPAT, which is based on critical information from the MD&A and footnotes.
NOPAT_GAAP
Gross NOPAT (Net Operating Profit After Tax)
Gross NOPAT is calculated like our regular NOPAT calculation but with depreciation and amortization expense added back.
NOPAT_GROSS
Return on Gross Invested Capital (ROGIC)
Return on Gross Invested Capital. Gross NOPAT divided by Average Gross Invested Capital. Gross NOPAT is calculated like our regular NOPAT calculation but with depreciation and amortization expense added back. Gross Invested Capital is calculated like our regular Invested Capital calculation, but also includes accumulated depreciation and amortization.
ROGIC
ROIC (Return On Invested Capital)
ROIC (Return On Invested Capital)
ROIC
ROIC (Return On Invested Capital) Using Ending Invested Capital
Return on invested capital using period-end invested capital.
ROIC_CAPITAL_INVESTED
ROIC (Return On Invested Capital) Using Beginning Invested Capital
Return on invested capital using period-beginning invested capital.
ROIC_CAPITAL_INVESTED_BEGINNING
ROIC (Return On Invested Capital) Using Average Quarterly Invested Capital
Return on invested capital using the average invested capital of the last four quarters.
ROIC_CAPITAL_INVESTED_Q_AVG
ROIC (Return On Invested Capital) Using Year-over-Year Average Invested Capital
Return on invested capital using the year-over-year average invested capital.
ROIC_CAPITAL_INVESTED_YOY_AVG
GAAP-Based ROIC
Return on Invested Capital calculated based only on reported GAAP data from the financial statements. GAAP-Based NOPAT and Average Invested Capital is what is generally provided by other data providers. This is compared to New Constructs' NOPAT and Average Invested Capital, which are based on critical information from the MD&A and footnotes.
ROIC_GAAP

*Indicates the datapoint is affected by stock price.

API: Fundamental Data Errors

Error
Message
Error Code
DataPointNotFound
The requested datapoint was not found.
404