Investment List API

RequestRetrieveInvestmentList

object
* Additional properties are NOT allowed.
datapointsarray[string]required

Lists data points to return. Retrieve valid values programmatically via GET /direct-web-services/v1/investment-list/data-points, or browse the full reference in the data dictionary.

<= 50 items

Example:["companyInformation.cik","companyInformation.legalName","companyInformation.morningstarSectorCode","balanceSheet.totalAssetsValueFY","basicReference.isin"]

investmentsarray[object]required

Investment to query. Investment look up is supported.

* Additional properties are NOT allowed.
Show Child Parameters
sortarray[object]
* Additional properties are NOT allowed.
Show Child Parameters
languageIdstring

Gets or sets the language for the investment list results.

currencyIdstring

Gets or sets the currency for the investment list results.

Example

ResponseRetireveInvestmentList

object

Response including results and metadata.

* Additional properties are NOT allowed.
investmentsarray[object]read-only

Output investment.

Show Child Parameters
metadataobjectread-only

Metadata returned in response including information about input investment identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
Example

ResponseGetDataPoints

array

List of supported data points and associated metadata.

namestringrequired

The data point identifier in dot-notation, used as the value in the dataPoints request array.

Allowed values:annualReportFeesAndFinancialsMostRecent.totalExpenseRatioannualReturnsHistorical.annualRet2020annualReturnsHistorical.annualRet2021annualReturnsHistorical.annualRet2022annualReturnsHistorical.annualRet2023annualReturnsHistorical.annualRet2024assetAllocationBreakdown.assetAllocBondPercNetassetAllocationBreakdown.assetAllocCashPercNetassetAllocationBreakdown.assetAllocEquityPercNetassetAllocationBreakdown.assetAllocOtherPercNetbasicReference.baseCurrencybasicReference.countryAvailableForSalebasicReference.domicilebasicReference.firmNamebasicReference.fundCodebasicReference.fundidbasicReference.fundLegalNamebasicReference.inceptionDatebasicReference.investmentTypebasicReference.isinbasicReference.legalNamebasicReference.namebasicReference.portfolioDatebasicReference.primarySharebasicReference.shareClassTypebasicReference.tickerbestAndWorstRollingReturns.best3MoAsOfDateQtrEndbestAndWorstRollingReturns.best3MoRetInceptionQtrEndbestAndWorstRollingReturns.worst3MoAsOfDateQtrEndbestAndWorstRollingReturns.worst3MoRetInceptionQtrEndcompanyGrade.growthGradecompanyGrade.profitabilityGradecompanyInformation.cikcompanyInformation.companyIdcompanyInformation.companyStatuscompanyInformation.domicileCountryCodecompanyInformation.globalTemplateIndustryTemplateCodecompanyInformation.legalNamecompanyInformation.legalNameLanguageCodecompanyInformation.leicompanyInformation.morningstarIndustryCodecompanyInformation.morningstarIndustryGroupCodecompanyInformation.morningstarSectorCodecompanyInformation.operationStatuscompanyInformation.shortNamecompanyInformation.standardNamecompanyInformation.webAddresscountryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaledcountryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaledcountryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaledcountryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaleddailyDividendResidualRiskAndReturnSensitivity.beta1260DaydailyReturnsMostRecent.returnDateDailydailyReturnsMostRecent.totalRet1DayDailydailyReturnsMostRecent.totalRet1MoDailydailyReturnsMostRecent.totalRet1WkDailydailyReturnsMostRecent.totalRet1YrDailydailyReturnsMostRecent.totalRet3MoDailydailyReturnsMostRecent.totalRet6MoDailydailyReturnsMostRecent.totalRetAnnlzd10YrDailydailyReturnsMostRecent.totalRetAnnlzd3YrDailydailyReturnsMostRecent.totalRetAnnlzd5YrDailydailyReturnsMostRecent.totalRetYtdDailydailyStandardDeviation.arithmeticMean1008DaydailyStandardDeviation.arithmeticMean1260DaydailyStandardDeviation.arithmeticMean2520DaydailyStandardDeviation.arithmeticMean252DaydailyStandardDeviation.arithmeticMean504DaydailyStandardDeviation.arithmeticMean756DaydailyStandardDeviation.dailyStandardDeviationAsOfDatedailyStandardDeviation.standardDeviation1008DaydailyStandardDeviation.standardDeviation1260DaydailyStandardDeviation.standardDeviation2520DaydailyStandardDeviation.standardDeviation252DaydailyStandardDeviation.standardDeviation504DaydailyStandardDeviation.standardDeviation756DaydelistInformation.delistingDatederivedStatisticsFromIndexLevelsTimeSeries.averageAnnualReportNetExpenseRatioderivedStatsIEMptCurrent.sharpeRatio3YrMoEndderivedStatsIEMptCurrent.stdDev3YrMoEnddividendResidualRiskAndReturnSensitivity.alpha12MonthdividendResidualRiskAndReturnSensitivity.alpha36MonthdividendResidualRiskAndReturnSensitivity.alpha60MonthdividendResidualRiskAndReturnSensitivity.beta12MonthdividendResidualRiskAndReturnSensitivity.beta36MonthdividendResidualRiskAndReturnSensitivity.beta60MonthdividendResidualRiskAndReturnSensitivity.rSquare12MonthdividendResidualRiskAndReturnSensitivity.rSquare36MonthdividendResidualRiskAndReturnSensitivity.rSquare60MonthenterpriseValueCalculations.cashReturnenterpriseValueCalculations.enterpriseValueenterpriseValueCalculations.enterpriseValueToEbitdaRatioenterpriseValueCalculations.enterpriseValueToEbitRatioenterpriseValueCalculations.enterpriseValueToFreeCashFlowRatioenterpriseValueCalculations.enterpriseValueToRevenueRatioenterpriseValueCalculations.totalDebtToEnterpriseValueequityPortfolioStatistics.averageMarketCapMilLongequityPortfolioStatistics.equityStyleFactorDivYldLongequityPortfolioStatistics.numberOfHoldingsequityPortfolioStatistics.percAssetInTop10HoldingsequityPortfolioStatistics.porbRatioTtmLongequityPortfolioStatistics.poreRatioTtmLongequityPortfolioStatistics.roePercTtmLongequityResearchRatingsMostRecent.priceOrFairValueequityResearchRatingsMostRecent.stockCapitalAllocationRatingesgFundLevelCarbonRisk.portfolioCarbonRiskScoreesgFundLevelRatingsHistorical.morningstarSustainabilityRatingesgFundLevelRatingsHistorical.portfolioCorporateSustainabilityScoreesgFundLevelRatingsHistorical.portfolioEnvironmentalRiskScoreesgFundLevelRatingsHistorical.portfolioGovernanceRiskScoreesgFundLevelRatingsHistorical.portfolioSocialRiskScoreesgFundLevelRatingsMostRecent.sustainabilityRatingDatefeeLevelRanks.morningstarFeeLevelBroadfinancialHealthGrade.financialHealthGradeValuefinancialHealthGrade.probabilityOfDefaultfixedIncomePortfolioStatisticsSurveyedAnalytics.averageCreditQualityfixedIncomePortfolioStatisticsSurveyedAnalytics.averageEffDurationSurveyfixedIncomePortfolioStatisticsSurveyedAnalytics.averageYtmSurveyfundAttributes.activelyManagedfundAttributes.fundOfFundsfundAttributes.indexFundfundAttributes.openForInvestmentindexTick.indexPriceindexTick.indexPricePublicationTimeinstrumentIdentifiers.localCodeinstrumentIdentifiers.vendorTickerSymbolinvestmentBasicDetails.advisorinvestmentBasicDetails.distributorinvestmentBasicDetails.exchangeinvestmentBasicDetails.exchangeCountryinvestmentBasicDetails.firmCountryinvestmentBasicDetails.managementCompanyinvestmentBasicDetails.primaryProspectusBenchmarkinvestmentBasicDetails.primaryProspectusBenchmarkIdinvestmentBasicDetails.subadvisormanagerBioAndDetailsMostRecent.managerNamemanagerBioAndDetailsMostRecent.managerTenureAveragemanagerBioAndDetailsMostRecent.managerTenureLongestmarketCapital.asOfDatemarketCapital.companyLevelMarketCapitalmarketCapital.currencyCodemarketCapital.shareLevelMarketCapitalmarketCapitalBreakdown.marketCapGiantPercLongRescaledmarketCapitalBreakdown.marketCapLargePercLongRescaledmarketCapitalBreakdown.marketCapMidPercLongRescaledmarketCapitalBreakdown.marketCapSmallPercLongRescaledmarketReturn.asOfDatemarketReturn.nonDividendTotalReturnMonthToDatemarketReturn.nonDividendTotalReturnOneDaymarketReturn.totalGrossedUpReturnDateToDatemarketReturn.totalGrossedUpReturnMonthToDatemarketReturn.totalGrossedUpReturnQuarterToDatemarketReturn.totalGrossedUpReturnWeekToDatemarketReturn.totalGrossedUpReturnYearToDatemarketReturn.totalReturnMonthToDatemarketReturn.totalReturnOneDaymarketReturn.totalReturnQuarterToDatemarketReturn.totalReturnWeekToDatemarketReturn.totalReturnYearToDatemetadata.priceFrequencyFlagmonthEndReturnStatistics.asOfDatemonthEndReturnStatistics.best3MonthTotalReturnOverPast120MonthsmonthEndReturnStatistics.best3MonthTotalReturnOverPast12MonthsmonthEndReturnStatistics.best3MonthTotalReturnOverPast36MonthsmonthEndReturnStatistics.best3MonthTotalReturnOverPast60MonthsmonthEndReturnStatistics.worst3MonthTotalReturnOverPast120MonthsmonthEndReturnStatistics.worst3MonthTotalReturnOverPast12MonthsmonthEndReturnStatistics.worst3MonthTotalReturnOverPast36MonthsmonthEndReturnStatistics.worst3MonthTotalReturnOverPast60MonthsmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1MoMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrQtrEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet3MoMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet6MoMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd10YrMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd10YrQtrEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrQtrEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrQtrEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetInceptionMoEndmonthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetYtdMoEndmonthlyStandardDeviation.arithmeticMean120MonthmonthlyStandardDeviation.arithmeticMean12MonthmonthlyStandardDeviation.arithmeticMean24MonthmonthlyStandardDeviation.arithmeticMean36MonthmonthlyStandardDeviation.arithmeticMean48MonthmonthlyStandardDeviation.arithmeticMean60MonthmonthlyStandardDeviation.asOfDatemonthlyStandardDeviation.standardDeviation120MonthmonthlyStandardDeviation.standardDeviation12MonthmonthlyStandardDeviation.standardDeviation24MonthmonthlyStandardDeviation.standardDeviation36MonthmonthlyStandardDeviation.standardDeviation48MonthmonthlyStandardDeviation.standardDeviation60MonthmorningstarCategory.globalBroadCategoryGroupmorningstarCategory.globalCategorymorningstarCategory.morningstarCategoryIdmorningstarEquitySectorsBreakdown.equityEconSectorConsumerCyclicalPercLongRescaledmorningstarEquitySectorsBreakdown.equityEconSectorConsumerDefensivePercLongRescaledmorningstarEquitySectorsBreakdown.equityEconSectorEnergyPercLongRescaledmorningstarEquitySectorsBreakdown.equityEconSectorFinancialServicesPercLongRescaledmorningstarEquitySectorsBreakdown.equityEconSectorHealthcarePercLongRescaledmorningstarEquitySectorsBreakdown.equityEconSectorTechnologyPercLongRescaledmorningstarMedalistRatingMostRecent.morningstarMedalistRatingmorningstarMedalistRatingMostRecent.morningstarMedalistRatingDatemorningstarMedalistRatingMostRecent.morningstarMedalistRatingParentPillarmorningstarMedalistRatingMostRecent.morningstarMedalistRatingPeoplePillarmorningstarMedalistRatingMostRecent.morningstarMedalistRatingProcessPillarmorningstarPortfolioRiskScore.portfolioRiskScoremorningstarPortfolioRiskScore.portfolioRiskScoreDatemorningstarRatingMostRecent.morningstarRating10YrmorningstarRatingMostRecent.morningstarRating3YrmorningstarRatingMostRecent.morningstarRating5YrmorningstarRatingMostRecent.morningstarRatingOverallmorningstarRatingMostRecent.ratingDatemorningstarStyleBox.equityStyleBoxLongmorningstarStyleBox.sizeScoreLongmorningstarStyleBox.valueGrowthScoreLongmsciCountryClassification.msciCountrynetAssetsMonthEndMostRecent.firmTotalAssetsnetAssetsMonthEndMostRecent.fundSizenetAssetsMonthEndMostRecent.netAssetsDatenonDividendResidualRiskAndReturnSensitivity.nonDividendBeta36MonthnonDividendResidualRiskAndReturnSensitivity.nonDividendRSquare36MonthperformanceRanks.bearMarketRankPercMoEndperformanceRanks.totalRetPercRankCat10YrMoEndperformanceRanks.totalRetPercRankCat1YrMoEndperformanceRanks.totalRetPercRankCat3YrMoEndperformanceRanks.totalRetPercRankCat5YrMoEndperformanceRanks.totalRetPercRankCatYtdMoEndperformanceStatistics.midNetChangeperformanceStatistics.midPercentChangepriceMultiples.capeRatiopriceMultiples.normalizedPegRatiopriceMultiples.normalizedPriceToEarningsRatiopriceMultiples.normalizedPriceToEarningsRatioNormalizedProfitabilityMetricspriceMultiples.normalizedPriceToEbitdaRatiopriceMultiples.normalizedPriceToEbitdarRatiopriceMultiples.normalizedPriceToEbitRatiopriceMultiples.priceEarningsToGrowthRatiopriceMultiples.priceToAdjustedFundsFromOperationspriceMultiples.priceToBookRatiopriceMultiples.priceToCashFlowRatiopriceMultiples.priceToCashRatiopriceMultiples.priceToEarningsRatiopriceMultiples.priceToEbitdaRatiopriceMultiples.priceToEbitdarRatiopriceMultiples.priceToEbitRatiopriceMultiples.priceToFreeCashFlowRatiopriceMultiples.priceToFundsFromOperationspriceMultiples.priceToSalesRatiopriceMultiples.priceToTangibleBookValueRatiopriceMultiples.privateEps10priceMultiples.privateNetEarnings10priceMultiplestatistics.asOfDatepricesMostRecent.avgDailyVolume1MopricesMostRecent.avgDailyVolume1YrpricesMostRecent.avgDailyVolume3MopricesMostRecent.below52WkHighPercpricesMostRecent.datePrice52WkHighpricesMostRecent.datePrice52WkLowpricesMostRecent.lastClosepricesMostRecent.monthEndPricepricesMostRecent.monthEndPriceDatepricesMostRecent.navMoEndpricesMostRecent.price52WkHighpricesMostRecent.price52WkLowpriceYields.earningsYieldprospectusFees.managementFeeprospectusFees.maxFrontLoadprospectusFees.prospectusGrossExpenseRatioprospectusFees.prospectusNetExpenseRatiopurchaseDetails.closedToAllInvpurchaseDetails.minimumAdditionalPurchasepurchaseDetails.minimumInvestmentBaseCurrencypurchaseDetails.shareClassClosedToNewInvpurchaseDetails.surveyedKiidSrriquantitativeFairValues.asOfClosePriceDatequantitativeFairValues.closePricequantitativeFairValues.quantitativeFairValuequantitativeFairValues.quantitativeFairValueDatequantitativeFairValues.quantitativeFairValueUncertaintyquantitativeFairValues.quantitativeFairValueUncertaintyLabelquantitativeFairValues.quantitativeFinancialHealthquantitativeFairValues.quantitativeFiveStarPricequantitativeFairValues.quantitativeMoatquantitativeFairValues.quantitativeOneStarPricequantitativeRatings.quantitativePriceToFairValuequantitativeRatings.quantitativeStarRatingquantitativeRatings.quantitativeValuationLabelreference.countryNamereference.marketSectorCodereference.marketSegmentCodereference.morningstarVenueIdreturnsPerformanceCurrent.returnDateMoEndriskStatistics.alpha3YrMoEndriskStatistics.beta3YrMoEndriskStatistics.downsideCaptureRatio3YrMoEndriskStatistics.informationRatio3YrMoEndriskStatistics.rSquared3YrMoEndriskStatistics.sortinoRatio3YrMoEndriskStatistics.trackingError3YrMoEndriskStatistics.upsideCaptureRatio3YrMoEndshareClassInformation.cusipshareClassInformation.exchangeCodeshareClassInformation.exchangeSubMarketGlobalIdshareClassInformation.investmentIdshareClassInformation.investmentStatusshareClassInformation.investmentTypeshareClassInformation.ipoDateshareClassInformation.ipoOfferPriceshareClassInformation.isDrshareClassInformation.isMainShareshareClassInformation.isPrimaryPerformanceIdshareClassInformation.marketSymbolshareClassInformation.performanceStatusshareClassInformation.securityTypeshareClassInformation.sedolshareClassInformation.segmentMicCodeshareClassInformation.symbolshareClassInformation.tradingCurrencyshareClassInformation.tradingStatusshortInterest.daysToCovershortInterest.percentageOfFloatshortInterest.percentageOfSharesOutstandingshortInterest.shortInterestValuetrailingReturn.dailyMarketReturnIndextrailingReturn.trailing10YearReturntrailingReturn.trailing15YearReturntrailingReturn.trailing1DayReturntrailingReturn.trailing1MonthReturntrailingReturn.trailing1WeekReturntrailingReturn.trailing1YearReturntrailingReturn.trailing20YearReturntrailingReturn.trailing2MonthReturntrailingReturn.trailing2YearReturntrailingReturn.trailing3MonthReturntrailingReturn.trailing3YearReturntrailingReturn.trailing4YearReturntrailingReturn.trailing5YearReturntrailingReturn.trailing6MonthReturntrailingReturn.trailing6YearReturntrailingReturn.trailing7YearReturntrailingReturn.trailing8YearReturntrailingReturn.trailing9MonthReturntrailingReturn.trailing9YearReturntrailingReturn.trailingGrossedUp10YearReturntrailingReturn.trailingGrossedUp15YearReturntrailingReturn.trailingGrossedUp1DayReturntrailingReturn.trailingGrossedUp1MonthReturntrailingReturn.trailingGrossedUp1WeekReturntrailingReturn.trailingGrossedUp1YearReturntrailingReturn.trailingGrossedUp20YearReturntrailingReturn.trailingGrossedUp2MonthReturntrailingReturn.trailingGrossedUp2YearReturntrailingReturn.trailingGrossedUp3MonthReturntrailingReturn.trailingGrossedUp3YearReturntrailingReturn.trailingGrossedUp4YearReturntrailingReturn.trailingGrossedUp5YearReturntrailingReturn.trailingGrossedUp6MonthReturntrailingReturn.trailingGrossedUp6YearReturntrailingReturn.trailingGrossedUp7YearReturntrailingReturn.trailingGrossedUp8YearReturntrailingReturn.trailingGrossedUp9MonthReturntrailingReturn.trailingGrossedUp9YearReturntrailingReturn.trailingReturnAsOfDateyieldsMostRecent.secYield

aliasstring

An alternative identifier for this data point where one exists. When present, the alias may be used in place of name in requests.

Example:name, performanceId

typestringrequired

The primitive type of the value returned for this data point.

Allowed values:stringdecimalintbool

InputInvestment

object

Investment to query. Investment look up is supported.

* Additional properties are NOT allowed.
idstringrequired

Investment to query. Accepts performance IDs, ISINs, security IDs, CUSIPs, trading symbols, and Morningstar IDs.

>= 1 characters

Example:0P00000046, US0042391096

idTypestring

Identifier type.

Allowed values:performanceIdisinfundCodesecurityIdcusipmsidtradingSymbol

Default:performanceId

baseCurrencystring

Input base currency used to look up Investment identifier

Example:USD, JPY

domicilestring

Domicile used to look up investment. Accepts 3-character ISO 3166-1 country codes.

Example:USA, JPN

exchangeCountrystring

Exchange country used to look up investment. Accepts 3-character ISO 3166-1 country codes.

Example:USA, JPN

exchangeIdstring

Exchange identifier used to look up investment.

Example:EX$$$$XNAS, EX$$$$XLON

Example

InputSort

object
* Additional properties are NOT allowed.
dataPointstring
orderBystring
Example