--- title: "Retrieve investment list." url: "https://developer-beta.morningstar.com/apis/investment-list-api/versions/90f4a97d-5cec-479b-81cc-6346f8ec5d62/operations/retrieveInvestmentList" --- > Full API specification: https://developer-beta.morningstar.com/apis/investment-list-api/versions/90f4a97d-5cec-479b-81cc-6346f8ec5d62.md # Retrieve investment list. `POST` `/direct-web-services/v1/investment-list` Operation ID: `retrieveInvestmentList` ## Request body (required) Content types: `application/json` ## Responses - `200` - OK - `400` - Bad Request - `401` - Unauthorized - `403` - Forbidden - `500` - Internal Server Error ## OpenAPI definition ```yaml openapi: 3.1.0 info: title: Investment List API version: "1.0" servers: - url: https://www.us-api.morningstar.com description: Americas - url: https://www.apac-api.morningstar.com description: APAC - url: https://www.emea-api.morningstar.com description: EMEA paths: /direct-web-services/v1/investment-list: post: summary: Retrieve investment list. responses: "200": $ref: "#/components/responses/ResponseRetrieveInvestmentList" "400": $ref: "#/components/responses/ResponseBadRequest" "401": $ref: "#/components/responses/ResponseUnauthorized" "403": $ref: "#/components/responses/ResponseForbidden" "500": $ref: "#/components/responses/ResponseInternalServerError" operationId: retrieveInvestmentList tags: - Investment List requestBody: $ref: "#/components/requestBodies/RequestRetrieveInvestmentList" security: - Bearer: [] components: responses: ResponseRetrieveInvestmentList: description: OK content: application/json: schema: $ref: "#/components/schemas/ResponseRetrieveInvestmentList" examples: ResponseRetrieveInvestmentListExample1: $ref: "#/components/examples/ResponseRetrieveInvestmentListExample1" ResponseBadRequest: description: Bad Request content: application/json: schema: $ref: "#/components/schemas/OutputErrorDetails" examples: ResponseBadRequestExample1: $ref: "#/components/examples/ResponseBadRequestExample1" ResponseBadRequestExample2: $ref: "#/components/examples/ResponseBadRequestExample2" ResponseBadRequestExample3: $ref: "#/components/examples/ResponseBadRequestExample3" ResponseBadRequestExample4: $ref: "#/components/examples/ResponseBadRequestExample4" ResponseBadRequestExample5: $ref: "#/components/examples/ResponseBadRequestExample5" ResponseBadRequestExample6: $ref: "#/components/examples/ResponseBadRequestExample6" ResponseBadRequestExample7: $ref: "#/components/examples/ResponseBadRequestExample7" ResponseUnauthorized: description: Unauthorized content: application/json: schema: $ref: "#/components/schemas/OutputErrorDetails" ResponseForbidden: description: Forbidden content: application/json: schema: $ref: "#/components/schemas/OutputErrorDetails" ResponseInternalServerError: description: Internal Server Error content: application/json: schema: $ref: "#/components/schemas/OutputErrorDetails" requestBodies: RequestRetrieveInvestmentList: required: true content: application/json: schema: $ref: "#/components/schemas/RequestRetrieveInvestmentList" examples: RequestRetrieveInvestmentListExample1: $ref: "#/components/examples/RequestRetrieveInvestmentListExample1" RequestRetrieveInvestmentListExample2: $ref: "#/components/examples/RequestRetrieveInvestmentListExample2" RequestRetrieveInvestmentListExample3: $ref: "#/components/examples/RequestRetrieveInvestmentListExample3" RequestRetrieveInvestmentListExample4: $ref: "#/components/examples/RequestRetrieveInvestmentListExample4" RequestRetrieveInvestmentListExample5: $ref: "#/components/examples/RequestRetrieveInvestmentListExample5" RequestRetrieveInvestmentListExample6: $ref: "#/components/examples/RequestRetrieveInvestmentListExample6" RequestRetrieveInvestmentListExample7: $ref: "#/components/examples/RequestRetrieveInvestmentListExample7" RequestRetrieveInvestmentListExample8: $ref: "#/components/examples/RequestRetrieveInvestmentListExample8" schemas: ResponseRetrieveInvestmentList: title: ResponseRetireveInvestmentList description: Response including results and metadata. type: object properties: investments: type: array items: $ref: "#/components/schemas/OutputInvestment" nullable: true readOnly: true metadata: $ref: "#/components/schemas/OutputMetadata" additionalProperties: false OutputErrorDetails: type: object properties: statusCode: type: integer description: Status Code format: int32 errorCode: type: string description: Custom error code nullable: true message: type: string description: Message nullable: true requestId: type: string description: RequestId nullable: true additionalProperties: false description: Error details RequestRetrieveInvestmentList: type: object properties: datapoints: type: array items: type: string maxItems: 50 description: 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. nullable: true examples: - - companyInformation.cik - companyInformation.legalName - companyInformation.morningstarSectorCode - balanceSheet.totalAssetsValueFY - basicReference.isin externalDocs: description: Data dictionary (Excel) url: https://developer.morningstar.com/content/hidden-from-navigation/InvestmentListDataDictionary.xlsx investments: type: array items: $ref: "#/components/schemas/InputInvestment" nullable: true description: List of investments to query. sort: type: array items: $ref: "#/components/schemas/InputSort" nullable: true languageId: type: string description: Gets or sets the language for the investment list results. nullable: true currencyId: type: string description: Gets or sets the currency for the investment list results. nullable: true additionalProperties: false required: - datapoints - investments OutputInvestment: description: Output investment. type: object title: OutputInvestment required: - performanceId properties: performanceId: type: string alias: performanceId nullable: false aggregateSummary.openInterest: type: number format: double nullable: true aggregateSummary.tradeCount: type: number format: double nullable: true aggregateSummary.turnover: type: number format: double nullable: true aggregateSummary.vwap: type: number format: double nullable: true annualReportFeesAndFinancialsMostRecent.totalExpenseRatio: type: string nullable: true annualReturnsHistorical.annualRet2020: type: string nullable: true annualReturnsHistorical.annualRet2021: type: string nullable: true annualReturnsHistorical.annualRet2022: type: string nullable: true annualReturnsHistorical.annualRet2023: type: string nullable: true annualReturnsHistorical.annualRet2024: type: string nullable: true assetAllocationBreakdown.assetAllocBondPercNet: type: string nullable: true assetAllocationBreakdown.assetAllocCashPercNet: type: string nullable: true assetAllocationBreakdown.assetAllocEquityPercNet: type: string nullable: true assetAllocationBreakdown.assetAllocOtherPercNet: type: string nullable: true basicReference.baseCurrency: type: string nullable: true basicReference.countryAvailableForSale: type: string nullable: true basicReference.domicile: type: string nullable: true basicReference.firmName: type: string nullable: true basicReference.fundCode: type: string nullable: true basicReference.fundLegalName: type: string nullable: true basicReference.fundid: type: string nullable: true basicReference.inceptionDate: type: string nullable: true basicReference.investmentType: type: string nullable: true basicReference.isin: type: string nullable: true basicReference.name: type: string nullable: true basicReference.portfolioDate: type: string nullable: true basicReference.primaryShare: type: string nullable: true basicReference.shareClassType: type: string nullable: true basicReference.ticker: type: string nullable: true bestAndWorstRollingReturns.best3MoAsOfDateQtrEnd: type: string nullable: true bestAndWorstRollingReturns.best3MoRetInceptionQtrEnd: type: string nullable: true bestAndWorstRollingReturns.worst3MoAsOfDateQtrEnd: type: string nullable: true bestAndWorstRollingReturns.worst3MoRetInceptionQtrEnd: type: string nullable: true closePrice.closePrice: type: number format: double nullable: true closePrice.closePriceDatetime: type: string nullable: true companyGrade.growthGrade: type: string nullable: true companyGrade.profitabilityGrade: type: string nullable: true companyInformation.cik: type: string nullable: true companyInformation.companyId: type: string nullable: true companyInformation.companyStatus: type: string nullable: true companyInformation.domicileCountryCode: type: string nullable: true companyInformation.globalTemplateIndustryTemplateCode: type: string nullable: true companyInformation.legalNameLanguageCode: type: string nullable: true companyInformation.lei: type: string nullable: true companyInformation.morningstarIndustryCode: type: string nullable: true companyInformation.morningstarIndustryGroupCode: type: string nullable: true companyInformation.morningstarSectorCode: type: string nullable: true companyInformation.operationStatus: type: string nullable: true companyInformation.shortName: type: string nullable: true companyInformation.standardName: type: string nullable: true companyInformation.webAddress: type: string nullable: true countryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaled: type: string nullable: true countryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaled: type: string nullable: true countryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaled: type: string nullable: true countryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaled: type: string nullable: true dailyDividendResidualRiskAndReturnSensitivity.beta1260Day: type: string nullable: true dailyReturnsMostRecent.returnDateDaily: type: string nullable: true dailyReturnsMostRecent.totalRet1DayDaily: type: string nullable: true dailyReturnsMostRecent.totalRet1MoDaily: type: string nullable: true dailyReturnsMostRecent.totalRet1WkDaily: type: string nullable: true dailyReturnsMostRecent.totalRet1YrDaily: type: string nullable: true dailyReturnsMostRecent.totalRet3MoDaily: type: string nullable: true dailyReturnsMostRecent.totalRet6MoDaily: type: string nullable: true dailyReturnsMostRecent.totalRetAnnlzd10YrDaily: type: string nullable: true dailyReturnsMostRecent.totalRetAnnlzd3YrDaily: type: string nullable: true dailyReturnsMostRecent.totalRetAnnlzd5YrDaily: type: string nullable: true dailyReturnsMostRecent.totalRetYtdDaily: type: string nullable: true dailyStandardDeviation.arithmeticMean1008Day: type: number format: double nullable: true dailyStandardDeviation.arithmeticMean1260Day: type: number format: double nullable: true dailyStandardDeviation.arithmeticMean2520Day: type: number format: double nullable: true dailyStandardDeviation.arithmeticMean252Day: type: number format: double nullable: true dailyStandardDeviation.arithmeticMean504Day: type: number format: double nullable: true dailyStandardDeviation.arithmeticMean756Day: type: number format: double nullable: true dailyStandardDeviation.dailyStandardDeviationAsOfDate: type: string nullable: true dailyStandardDeviation.standardDeviation1008Day: type: number format: double nullable: true dailyStandardDeviation.standardDeviation1260Day: type: number format: double nullable: true dailyStandardDeviation.standardDeviation2520Day: type: number format: double nullable: true dailyStandardDeviation.standardDeviation252Day: type: number format: double nullable: true dailyStandardDeviation.standardDeviation504Day: type: number format: double nullable: true dailyStandardDeviation.standardDeviation756Day: type: number format: double nullable: true delistInformation.delistingDate: type: string nullable: true derivedStatisticsFromIndexLevelsTimeSeries.averageAnnualReportNetExpenseRatio: type: string nullable: true derivedStatsIEMptCurrent.sharpeRatio3YrMoEnd: type: string nullable: true derivedStatsIEMptCurrent.stdDev3YrMoEnd: type: string nullable: true dividendResidualRiskAndReturnSensitivity.alpha12Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.alpha36Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.alpha60Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.beta12Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.beta36Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.beta60Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.rSquare12Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.rSquare36Month: type: string nullable: true dividendResidualRiskAndReturnSensitivity.rSquare60Month: type: string nullable: true enterpriseValueCalculations.cashReturn: type: string nullable: true enterpriseValueCalculations.enterpriseValue: type: string nullable: true enterpriseValueCalculations.enterpriseValueToEbitdaRatio: type: string nullable: true enterpriseValueCalculations.enterpriseValueToEbitRatio: type: string nullable: true enterpriseValueCalculations.enterpriseValueToFreeCashFlowRatio: type: string nullable: true enterpriseValueCalculations.enterpriseValueToRevenueRatio: type: string nullable: true enterpriseValueCalculations.totalDebtToEnterpriseValue: type: string nullable: true equityPortfolioStatistics.averageMarketCapMilLong: type: string nullable: true equityPortfolioStatistics.equityStyleFactorDivYldLong: type: string nullable: true equityPortfolioStatistics.numberOfHoldings: type: string nullable: true equityPortfolioStatistics.percAssetInTop10Holdings: type: string nullable: true equityPortfolioStatistics.porbRatioTtmLong: type: string nullable: true equityPortfolioStatistics.poreRatioTtmLong: type: string nullable: true equityPortfolioStatistics.roePercTtmLong: type: string nullable: true equityResearchRatingsMostRecent.priceOrFairValue: type: string nullable: true equityResearchRatingsMostRecent.stockCapitalAllocationRating: type: string nullable: true esgFundLevelCarbonRisk.portfolioCarbonRiskScore: type: string nullable: true esgFundLevelRatingsHistorical.morningstarSustainabilityRating: type: string nullable: true esgFundLevelRatingsHistorical.portfolioCorporateSustainabilityScore: type: string nullable: true esgFundLevelRatingsHistorical.portfolioEnvironmentalRiskScore: type: string nullable: true esgFundLevelRatingsHistorical.portfolioGovernanceRiskScore: type: string nullable: true esgFundLevelRatingsHistorical.portfolioSocialRiskScore: type: string nullable: true esgFundLevelRatingsMostRecent.sustainabilityRatingDate: type: string nullable: true feeLevelRanks.morningstarFeeLevelBroad: type: string nullable: true financialHealthGrade.financialHealthGradeValue: type: string nullable: true financialHealthGrade.probabilityOfDefault: type: string nullable: true fixedIncomePortfolioStatisticsSurveyedAnalytics.averageCreditQuality: type: string nullable: true fixedIncomePortfolioStatisticsSurveyedAnalytics.averageEffDurationSurvey: type: string nullable: true fixedIncomePortfolioStatisticsSurveyedAnalytics.averageYtmSurvey: type: string nullable: true fundAttributes.activelyManaged: type: string nullable: true fundAttributes.fundOfFunds: type: string nullable: true fundAttributes.indexFund: type: string nullable: true fundAttributes.openForInvestment: type: string nullable: true indexTick.indexPrice: type: number format: double nullable: true indexTick.indexPricePublicationTime: type: string nullable: true instrumentIdentifiers.exchangeTickerSymbol: type: string nullable: true instrumentIdentifiers.isin: type: string nullable: true instrumentIdentifiers.localCode: type: string nullable: true instrumentIdentifiers.mdCusip: type: string nullable: true instrumentIdentifiers_performanceId: type: string nullable: true instrumentIdentifiers.sedol: type: string nullable: true instrumentIdentifiers.vendorTickerSymbol: type: string nullable: true investmentBasicDetails.advisor: type: string nullable: true investmentBasicDetails.distributor: type: string nullable: true investmentBasicDetails.exchange: type: string nullable: true investmentBasicDetails.exchangeCountry: type: string nullable: true investmentBasicDetails.firmCountry: type: string nullable: true investmentBasicDetails.managementCompany: type: string nullable: true investmentBasicDetails.primaryProspectusBenchmark: type: string nullable: true investmentBasicDetails.primaryProspectusBenchmarkId: type: string nullable: true investmentBasicDetails.subadvisor: type: string nullable: true lastPrice.lastPrice: type: number format: double nullable: true lastPrice.lastPricePublishDatetime: type: string nullable: true lastPrice.lastSize: type: number format: double nullable: true managerBioAndDetailsMostRecent.managerName: type: string nullable: true managerBioAndDetailsMostRecent.managerTenureAverage: type: string nullable: true managerBioAndDetailsMostRecent.managerTenureLongest: type: string nullable: true marketCapital.asOfDate: type: string nullable: true marketCapital.companyLevelMarketCapital: type: string nullable: true marketCapital.currencyCode: type: string nullable: true marketCapital.shareLevelMarketCapital: type: string nullable: true marketCapitalBreakdown.marketCapGiantPercLongRescaled: type: string nullable: true marketCapitalBreakdown.marketCapLargePercLongRescaled: type: string nullable: true marketCapitalBreakdown.marketCapMidPercLongRescaled: type: string nullable: true marketCapitalBreakdown.marketCapSmallPercLongRescaled: type: string nullable: true marketReturn.asOfDate: type: string nullable: true marketReturn.nonDividendTotalReturnMonthToDate: type: number format: double nullable: true marketReturn.nonDividendTotalReturnOneDay: type: number format: double nullable: true marketReturn.totalGrossedUpReturnDateToDate: type: number format: double nullable: true marketReturn.totalGrossedUpReturnMonthToDate: type: number format: double nullable: true marketReturn.totalGrossedUpReturnQuarterToDate: type: number format: double nullable: true marketReturn.totalGrossedUpReturnWeekToDate: type: number format: double nullable: true marketReturn.totalGrossedUpReturnYearToDate: type: number format: double nullable: true marketReturn.totalReturnMonthToDate: type: number format: double nullable: true marketReturn.totalReturnOneDay: type: number format: double nullable: true marketReturn.totalReturnQuarterToDate: type: number format: double nullable: true marketReturn.totalReturnWeekToDate: type: number format: double nullable: true marketReturn.totalReturnYearToDate: type: number format: double nullable: true metadata.priceFrequencyFlag: type: string nullable: true midPrice.midPrice: type: number format: double nullable: true monthEndReturnStatistics.asOfDate: type: string nullable: true monthEndReturnStatistics.best3MonthTotalReturnOverPast120Months: type: number format: double nullable: true monthEndReturnStatistics.best3MonthTotalReturnOverPast12Months: type: number format: double nullable: true monthEndReturnStatistics.best3MonthTotalReturnOverPast36Months: type: number format: double nullable: true monthEndReturnStatistics.best3MonthTotalReturnOverPast60Months: type: number format: double nullable: true monthEndReturnStatistics.worst3MonthTotalReturnOverPast120Months: type: number format: double nullable: true monthEndReturnStatistics.worst3MonthTotalReturnOverPast12Months: type: number format: double nullable: true monthEndReturnStatistics.worst3MonthTotalReturnOverPast36Months: type: number format: double nullable: true monthEndReturnStatistics.worst3MonthTotalReturnOverPast60Months: type: number format: double nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1MoMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrQtrEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet3MoMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet6MoMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd10YrMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd10YrQtrEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrQtrEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrQtrEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetInceptionMoEnd: type: string nullable: true monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetYtdMoEnd: type: string nullable: true monthlyStandardDeviation.arithmeticMean120Month: type: number format: double nullable: true monthlyStandardDeviation.arithmeticMean12Month: type: number format: double nullable: true monthlyStandardDeviation.arithmeticMean24Month: type: number format: double nullable: true monthlyStandardDeviation.arithmeticMean36Month: type: number format: double nullable: true monthlyStandardDeviation.arithmeticMean48Month: type: number format: double nullable: true monthlyStandardDeviation.arithmeticMean60Month: type: number format: double nullable: true monthlyStandardDeviation.asOfDate: type: string nullable: true monthlyStandardDeviation.standardDeviation120Month: type: string nullable: true monthlyStandardDeviation.standardDeviation12Month: type: string nullable: true monthlyStandardDeviation.standardDeviation24Month: type: number format: double nullable: true monthlyStandardDeviation.standardDeviation36Month: type: string nullable: true monthlyStandardDeviation.standardDeviation48Month: type: number format: double nullable: true monthlyStandardDeviation.standardDeviation60Month: type: string nullable: true morningstarCategory.globalBroadCategoryGroup: type: string nullable: true morningstarCategory.globalCategory: type: string nullable: true morningstarCategory.morningstarCategoryId: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorConsumerCyclicalPercLongRescaled: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorConsumerDefensivePercLongRescaled: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorEnergyPercLongRescaled: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorFinancialServicesPercLongRescaled: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorHealthcarePercLongRescaled: type: string nullable: true morningstarEquitySectorsBreakdown.equityEconSectorTechnologyPercLongRescaled: type: string nullable: true morningstarMedalistRatingMostRecent.morningstarMedalistRating: type: string nullable: true morningstarMedalistRatingMostRecent.morningstarMedalistRatingDate: type: string nullable: true morningstarMedalistRatingMostRecent.morningstarMedalistRatingParentPillar: type: string nullable: true morningstarMedalistRatingMostRecent.morningstarMedalistRatingPeoplePillar: type: string nullable: true morningstarMedalistRatingMostRecent.morningstarMedalistRatingProcessPillar: type: string nullable: true morningstarPortfolioRiskScore.portfolioRiskScore: type: string nullable: true morningstarPortfolioRiskScore.portfolioRiskScoreDate: type: string nullable: true morningstarRatingMostRecent.morningstarRating10Yr: type: string nullable: true morningstarRatingMostRecent.morningstarRating3Yr: type: string nullable: true morningstarRatingMostRecent.morningstarRating5Yr: type: string nullable: true morningstarRatingMostRecent.morningstarRatingOverall: type: string nullable: true morningstarRatingMostRecent.ratingDate: type: string nullable: true morningstarStyleBox.equityStyleBoxLong: type: string nullable: true morningstarStyleBox.sizeScoreLong: type: string nullable: true morningstarStyleBox.valueGrowthScoreLong: type: string nullable: true msciCountryClassification.msciCountry: type: string nullable: true navPrice.exchangeNav: type: number format: double nullable: true netAssetsMonthEndMostRecent.firmTotalAssets: type: string nullable: true netAssetsMonthEndMostRecent.fundSize: type: string nullable: true netAssetsMonthEndMostRecent.netAssetsDate: type: string nullable: true nonDividendResidualRiskAndReturnSensitivity.nonDividendBeta36Month: type: string nullable: true nonDividendResidualRiskAndReturnSensitivity.nonDividendRSquare36Month: type: string nullable: true ohlPrice.highPrice: type: number format: double nullable: true ohlPrice.lowPrice: type: number format: double nullable: true ohlPrice.openPrice: type: number format: double nullable: true performanceRanks.bearMarketRankPercMoEnd: type: string nullable: true performanceRanks.totalRetPercRankCat10YrMoEnd: type: string nullable: true performanceRanks.totalRetPercRankCat1YrMoEnd: type: string nullable: true performanceRanks.totalRetPercRankCat3YrMoEnd: type: string nullable: true performanceRanks.totalRetPercRankCat5YrMoEnd: type: string nullable: true performanceRanks.totalRetPercRankCatYtdMoEnd: type: string nullable: true performanceStatistics.52WeekHighLowPrice: type: number format: double nullable: true performanceStatistics.52WeekHighPrice: type: number format: double nullable: true performanceStatistics.52WeekHighPriceDate: type: string nullable: true performanceStatistics.52WeekLowPriceDate: type: string nullable: true performanceStatistics.midNetChange: type: number format: double nullable: true performanceStatistics.midPercentChange: type: number format: double nullable: true performanceStatistics.netChange: type: number format: double nullable: true performanceStatistics.percentChange: type: number format: double nullable: true performanceStatistics.postmarketNetChange: type: number format: double nullable: true performanceStatistics.postmarketPercentChange: type: number format: double nullable: true performanceStatistics.premarketNetChange: type: number format: double nullable: true performanceStatistics.premarketPercentChange: type: number format: double nullable: true performanceStatistics.yearToDateHighPrice: type: number format: double nullable: true performanceStatistics.yearToDateHighPriceDate: type: string nullable: true performanceStatistics.yearToDateLowPrice: type: number format: double nullable: true performanceStatistics.yearToDateLowPriceDate: type: string nullable: true priceMultiples.capeRatio: type: number format: double nullable: true priceMultiples.normalizedPegRatio: type: number format: double nullable: true priceMultiples.normalizedPriceToEarningsRatio: type: number format: double nullable: true priceMultiples.normalizedPriceToEarningsRatioNormalizedProfitabilityMetrics: type: number format: double nullable: true priceMultiples.normalizedPriceToEbitdaRatio: type: number format: double nullable: true priceMultiples.normalizedPriceToEbitdarRatio: type: number format: double nullable: true priceMultiples.normalizedPriceToEbitRatio: type: number format: double nullable: true priceMultiples.priceEarningsToGrowthRatio: type: number format: double nullable: true priceMultiples.priceToAdjustedFundsFromOperations: type: number format: double nullable: true priceMultiples.priceToBookRatio: type: string nullable: true priceMultiples.priceToCashFlowRatio: type: string nullable: true priceMultiples.priceToCashRatio: type: number format: double nullable: true priceMultiples.priceToEarningsRatio: type: string nullable: true priceMultiples.priceToEbitdaRatio: type: string nullable: true priceMultiples.priceToEbitdarRatio: type: number format: double nullable: true priceMultiples.priceToEbitRatio: type: number format: double nullable: true priceMultiples.priceToFreeCashFlowRatio: type: string nullable: true priceMultiples.priceToFundsFromOperations: type: number format: double nullable: true priceMultiples.priceToSalesRatio: type: string nullable: true priceMultiples.priceToTangibleBookValueRatio: type: string nullable: true priceMultiples.privateEps10: type: number format: double nullable: true priceMultiples.privateNetEarnings10: type: number format: double nullable: true priceMultiplestatistics.asOfDate: type: string nullable: true pricesMostRecent.avgDailyVolume1Mo: type: string nullable: true pricesMostRecent.avgDailyVolume1Yr: type: string nullable: true pricesMostRecent.avgDailyVolume3Mo: type: string nullable: true pricesMostRecent.below52WkHighPerc: type: string nullable: true pricesMostRecent.datePrice52WkHigh: type: string nullable: true pricesMostRecent.datePrice52WkLow: type: string nullable: true pricesMostRecent.lastClose: type: string nullable: true pricesMostRecent.monthEndPrice: type: string nullable: true pricesMostRecent.monthEndPriceDate: type: string nullable: true pricesMostRecent.navMoEnd: type: string nullable: true pricesMostRecent.price52WkHigh: type: string nullable: true pricesMostRecent.price52WkLow: type: string nullable: true priceYields.earningsYield: type: string nullable: true prospectusFees.managementFee: type: string nullable: true prospectusFees.maxFrontLoad: type: string nullable: true prospectusFees.prospectusGrossExpenseRatio: type: string nullable: true prospectusFees.prospectusNetExpenseRatio: type: string nullable: true purchaseDetails.closedToAllInv: type: string nullable: true purchaseDetails.minimumAdditionalPurchase: type: string nullable: true purchaseDetails.minimumInvestmentBaseCurrency: type: string nullable: true purchaseDetails.shareClassClosedToNewInv: type: string nullable: true purchaseDetails.surveyedKiidSrri: type: string nullable: true quantitativeFairValues.asOfClosePriceDate: type: string nullable: true quantitativeFairValues.closePrice: type: number format: double nullable: true quantitativeFairValues.quantitativeFairValue: type: string nullable: true quantitativeFairValues.quantitativeFairValueDate: type: string nullable: true quantitativeFairValues.quantitativeFairValueUncertainty: type: number format: double nullable: true quantitativeFairValues.quantitativeFairValueUncertaintyLabel: type: string nullable: true quantitativeFairValues.quantitativeFinancialHealth: type: string nullable: true quantitativeFairValues.quantitativeFiveStarPrice: type: string nullable: true quantitativeFairValues.quantitativeMoat: type: string nullable: true quantitativeFairValues.quantitativeOneStarPrice: type: string nullable: true quantitativeRatings.quantitativePriceToFairValue: type: string nullable: true quantitativeRatings.quantitativeStarRating: type: string nullable: true quantitativeRatings.quantitativeValuationLabel: type: string nullable: true reference.assetType: type: string nullable: true reference.countryCode: type: string nullable: true reference.countryName: type: string nullable: true reference.currency: type: string nullable: true reference.instrumentDescription: type: string nullable: true reference.marketSectorCode: type: string nullable: true reference.marketSegmentCode: type: string nullable: true reference.morningstarVenueId: type: string nullable: true reference.operatingMic: type: string nullable: true reference.segmentMic: type: string nullable: true returnsPerformanceCurrent.returnDateMoEnd: type: string nullable: true riskStatistics.alpha3YrMoEnd: type: string nullable: true riskStatistics.beta3YrMoEnd: type: string nullable: true riskStatistics.downsideCaptureRatio3YrMoEnd: type: string nullable: true riskStatistics.informationRatio3YrMoEnd: type: string nullable: true riskStatistics.rSquared3YrMoEnd: type: string nullable: true riskStatistics.sortinoRatio3YrMoEnd: type: string nullable: true riskStatistics.trackingError3YrMoEnd: type: string nullable: true riskStatistics.upsideCaptureRatio3YrMoEnd: type: string nullable: true settlementPrice.finalSettlementPrice: type: number format: double nullable: true settlementPrice.todaysSettlementPrice: type: number format: double nullable: true shareClassInformation.cusip: type: string nullable: true shareClassInformation.exchangeCode: type: string nullable: true shareClassInformation.exchangeSubMarketGlobalId: type: string nullable: true shareClassInformation.investmentId: type: string nullable: true shareClassInformation.investmentStatus: type: integer format: int32 nullable: true shareClassInformation.investmentType: type: string nullable: true shareClassInformation.ipoDate: type: string nullable: true shareClassInformation.ipoOfferPrice: type: string nullable: true shareClassInformation.isDr: type: boolean nullable: true shareClassInformation.isMainShare: type: string nullable: true shareClassInformation.isPrimaryPerformanceId: type: boolean nullable: true shareClassInformation.marketSymbol: type: string nullable: true shareClassInformation.performanceStatus: type: string nullable: true shareClassInformation.securityType: type: string nullable: true shareClassInformation.sedol: type: string nullable: true shareClassInformation.segmentMicCode: type: string nullable: true shareClassInformation.symbol: type: string nullable: true shareClassInformation.tradingCurrency: type: string nullable: true shareClassInformation.tradingStatus: type: string nullable: true shortInterest.daysToCover: type: string nullable: true shortInterest.percentageOfFloat: type: string nullable: true shortInterest.percentageOfSharesOutstanding: type: string nullable: true shortInterest.shortInterestValue: type: string nullable: true topofbook.askPrice: type: number format: double nullable: true topofbook.askPriceClose: type: number format: double nullable: true topofbook.bidPrice: type: number format: double nullable: true topofbook.bidPriceClose: type: number format: double nullable: true tradePostmarket.postmarketCumulativeVolume: type: number format: double nullable: true tradePostmarket.postmarketTradePrice: type: number format: double nullable: true tradePostmarket.postmarketTradeSize: type: number format: double nullable: true tradePremarket.premarketCumulativeVolume: type: number format: double nullable: true tradePremarket.premarketTradePrice: type: number format: double nullable: true tradePremarket.premarketTradeSize: type: number format: double nullable: true trailingReturn.dailyMarketReturnIndex: type: number format: double nullable: true trailingReturn.trailing10YearReturn: type: string nullable: true trailingReturn.trailing15YearReturn: type: number format: double nullable: true trailingReturn.trailing1DayReturn: type: string nullable: true trailingReturn.trailing1MonthReturn: type: string nullable: true trailingReturn.trailing1WeekReturn: type: number format: double nullable: true trailingReturn.trailing1YearReturn: type: string nullable: true trailingReturn.trailing20YearReturn: type: number format: double nullable: true trailingReturn.trailing2MonthReturn: type: number format: double nullable: true trailingReturn.trailing2YearReturn: type: string nullable: true trailingReturn.trailing3MonthReturn: type: string nullable: true trailingReturn.trailing3YearReturn: type: string nullable: true trailingReturn.trailing4YearReturn: type: string nullable: true trailingReturn.trailing5YearReturn: type: string nullable: true trailingReturn.trailing6MonthReturn: type: string nullable: true trailingReturn.trailing6YearReturn: type: number format: double nullable: true trailingReturn.trailing7YearReturn: type: number format: double nullable: true trailingReturn.trailing8YearReturn: type: number format: double nullable: true trailingReturn.trailing9MonthReturn: type: number format: double nullable: true trailingReturn.trailing9YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp10YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp15YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp1DayReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp1MonthReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp1WeekReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp1YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp20YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp2MonthReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp2YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp3MonthReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp3YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp4YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp5YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp6MonthReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp6YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp7YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp8YearReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp9MonthReturn: type: number format: double nullable: true trailingReturn.trailingGrossedUp9YearReturn: type: number format: double nullable: true trailingReturn.trailingReturnAsOfDate: type: string nullable: true yieldsMostRecent.secYield: type: string nullable: true OutputMetadata: description: Metadata returned in response including information about input investment identifiers for which no results were found. title: OutputMetadata type: object readOnly: true properties: requestId: description: Indicates the request identifier. example: c63e7f6c-b52d-42c3-9d1b-4a4b4ac05f3c type: string readOnly: true time: description: Indicates time response was returned. example: 2025-10-02T10:54:36.9161062Z type: string format: date-time readOnly: true messages: type: array items: $ref: "#/components/schemas/OutputMetadataMessages" additionalProperties: false InputInvestment: required: - id type: object properties: id: minLength: 1 type: string description: Investment to query. Accepts performance IDs, ISINs, security IDs, CUSIPs, trading symbols, and Morningstar IDs. examples: - 0P00000046 - US0042391096 idType: type: string description: Identifier type. default: performanceId nullable: true enum: - performanceId - isin - fundCode - securityId - cusip - msid - tradingSymbol baseCurrency: type: string description: Input base currency used to look up Investment identifier nullable: true examples: - USD - JPY domicile: type: string description: Domicile used to look up investment. Accepts 3-character ISO 3166-1 country codes. nullable: true examples: - USA - JPN exchangeCountry: type: string description: Exchange country used to look up investment. Accepts 3-character ISO 3166-1 country codes. nullable: true examples: - USA - JPN exchangeId: type: string description: Exchange identifier used to look up investment. nullable: true examples: - EX$$$$XNAS - EX$$$$XLON externalDocs: description: List of exchange IDs. url: https://developer.morningstar.com/content/hidden-from-navigation/DwsIdLookUpExchangeIds.xlsx additionalProperties: false description: Investment to query. Investment look up is supported. InputSort: type: object properties: dataPoint: type: string nullable: true orderBy: type: string nullable: true additionalProperties: false OutputMetadataMessages: description: Provides information about identifiers for which no results were returned. title: OutputMetadataMessages type: object properties: investments: type: array items: $ref: "#/components/schemas/OutputInvalidInvestments" type: type: string description: Indicates the message type. example: Warning readOnly: true enum: - Warning code: type: string description: Code associated with the message. example: 404.common.125 readOnly: true message: type: string description: Description of the issue encountered. example: "Lookup : Invalid investments." readOnly: true additionalProperties: false OutputInvalidInvestments: type: object title: OutputInvalidInvestments description: Input investment identifiers for which no matching investment was found. properties: id: type: string description: Indicates identifier value passed in request. examples: - US2562191062 idType: type: string description: Indicates the identifier type passed in request. example: isin enum: - performanceId - isin - fundCode - securityId - cusip - msid - tradingSymbol errorCode: type: string description: TBC example: TBC performanceId: type: string description: Performance ID (if not passed in request). example: 0P000PPP6Q baseCurrency: type: string description: Input base currency used to look up investment identifier. domicile: type: string description: Input domicile used to look up investment identifier. exchangeCountry: type: string description: Input exchange country used to look up investment identifier. exchangeId: type: string description: Specifies the exchange identifier used to look up investment. additionalProperties: false examples: ResponseRetrieveInvestmentListExample1: summary: "Use Case: Performance Watchlist (Response)" description: >- Example output for the following use case: "I want to compare YTD, 1Y, 3Y, 5Y returns and see as-of dates." The response includes information about fields for which no data was returned. value: investments: - performanceId: 0P000000YF trailingReturn.trailingReturnAsOfDate: 2026-04-10 trailingReturn.trailing1MonthReturn: "0.000000" trailingReturn.trailing3MonthReturn: "900.000000" trailingReturn.trailing6MonthReturn: "-95.000000" trailingReturn.trailing1YearReturn: "-95.000000" trailingReturn.trailing3YearReturn: "0.000000" trailingReturn.trailing5YearReturn: "-51.689306" basicReference.name: CMTSU Liquidation Inc basicReference.ticker: CBRI dailyReturnsMostRecent.totalRet1DayDaily: "0" dailyReturnsMostRecent.totalRet1YrDaily: "0" dailyReturnsMostRecent.totalRetYtdDaily: "0" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: "9900.00000" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: "0.00000" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: "-51.43095" dailyReturnsMostRecent.totalRet1WkDaily: "-99" dailyReturnsMostRecent.totalRet1MoDaily: "-99" dailyReturnsMostRecent.returnDateDaily: 2026-04-10 monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: 2026-03-31 - performanceId: 0P000000YD instrumentIdentifiers.isin: US12541W2098 reference.assetType: STOCK reference.currency: USD trailingReturn.trailingReturnAsOfDate: 2026-04-10 trailingReturn.trailing1MonthReturn: "-7.034004" trailingReturn.trailing3MonthReturn: "-3.894127" trailingReturn.trailing6MonthReturn: "31.473945" trailingReturn.trailing1YearReturn: "83.881688" trailingReturn.trailing3YearReturn: "21.560638" trailingReturn.trailing5YearReturn: "12.465633" basicReference.name: C.H. Robinson Worldwide Inc basicReference.ticker: CHRW dailyReturnsMostRecent.totalRet1DayDaily: "-3.94242" dailyReturnsMostRecent.totalRet1YrDaily: "83.88169" dailyReturnsMostRecent.totalRetYtdDaily: "2.09007" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: "64.55078" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: "20.39440" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: "13.25928" dailyReturnsMostRecent.totalRet1WkDaily: "-2.59175" dailyReturnsMostRecent.totalRet1MoDaily: "-7.034" dailyReturnsMostRecent.returnDateDaily: 2026-04-10 monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: 2026-03-31 - performanceId: 0P000000YB instrumentIdentifiers.isin: US46122W3034 reference.assetType: STOCK reference.currency: USD trailingReturn.trailingReturnAsOfDate: 2026-04-10 trailingReturn.trailing1MonthReturn: "-29.182879" trailingReturn.trailing3MonthReturn: "-33.333333" trailingReturn.trailing6MonthReturn: "-44.680851" trailingReturn.trailing1YearReturn: "-51.466667" trailingReturn.trailing3YearReturn: "-14.265017" trailingReturn.trailing5YearReturn: "-28.397369" basicReference.name: Inuvo Inc basicReference.ticker: INUV dailyReturnsMostRecent.totalRet1DayDaily: "-3.19149" dailyReturnsMostRecent.totalRet1YrDaily: "-51.46667" dailyReturnsMostRecent.totalRetYtdDaily: "-26.6129" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: "-41.69014" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: "-10.80415" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: "-27.31010" dailyReturnsMostRecent.totalRet1WkDaily: "-13.33333" dailyReturnsMostRecent.totalRet1MoDaily: "-29.18288" dailyReturnsMostRecent.returnDateDaily: 2026-04-10 monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: 2026-03-31 - performanceId: 0P000000YA instrumentIdentifiers.isin: CA12532H1047 reference.assetType: STOCK reference.currency: USD trailingReturn.trailingReturnAsOfDate: 2026-04-10 trailingReturn.trailing1MonthReturn: "-5.895049" trailingReturn.trailing3MonthReturn: "-25.512954" trailingReturn.trailing6MonthReturn: "-21.163157" trailingReturn.trailing1YearReturn: "-28.494677" trailingReturn.trailing3YearReturn: "-10.183197" trailingReturn.trailing5YearReturn: "-3.507330" basicReference.name: CGI Inc Class A basicReference.ticker: GIB dailyReturnsMostRecent.totalRet1DayDaily: "-0.76814" dailyReturnsMostRecent.totalRet1YrDaily: "-28.49946" dailyReturnsMostRecent.totalRetYtdDaily: "-24.2856" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: "-26.31406" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: "-8.48967" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: "-2.38092" dailyReturnsMostRecent.totalRet1WkDaily: "-5.70424" dailyReturnsMostRecent.totalRet1MoDaily: "-5.89505" dailyReturnsMostRecent.returnDateDaily: 2026-04-10 monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: 2026-03-31 - performanceId: 0P000000W8 instrumentIdentifiers.isin: US1143401024 reference.assetType: STOCK reference.currency: USD trailingReturn.trailingReturnAsOfDate: 2026-04-10 trailingReturn.trailing1MonthReturn: "-2.502195" trailingReturn.trailing3MonthReturn: "-41.429325" trailingReturn.trailing6MonthReturn: "-25.494800" trailingReturn.trailing1YearReturn: "-16.299227" trailingReturn.trailing3YearReturn: "-20.468480" trailingReturn.trailing5YearReturn: "-25.132607" basicReference.name: Azenta Inc basicReference.ticker: AZTA dailyReturnsMostRecent.totalRet1DayDaily: "-1.98588" dailyReturnsMostRecent.totalRet1YrDaily: "-16.29923" dailyReturnsMostRecent.totalRetYtdDaily: "-33.22309" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd: "-39.03002" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd: "-22.06699" monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd: "-23.48040" dailyReturnsMostRecent.totalRet1WkDaily: "-1.85594" dailyReturnsMostRecent.totalRet1MoDaily: "-2.50219" dailyReturnsMostRecent.returnDateDaily: 2026-04-10 monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd: 2026-03-31 metadata: messages: - investments: - status: Datapoints are not entitled for 0P000000YF security datapointIds: - reference.currency - instrumentIdentifiers.isin - reference.assetType errorCode: "403" id: 0P000000YF type: Warning requestId: 85b6f9b2-01f9-4da8-90b8-5efb3c1ec31d time: 2026-04-13T14:41:48.4913734Z ResponseBadRequestExample1: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.002 message: The Investments parameter is required. requestId: 9b11227f-ee46-4bc6-a07f-d9f4321ae3ba ResponseBadRequestExample2: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.003 message: The number of datapoints exceeds limit. Maximum datapoints allowed are 50 per request requestId: daf1a426-0489-42f3-9144-540b3f3888b5 ResponseBadRequestExample3: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.003 message: The number of investments exceeds limit. Maximum investments allowed are 100 per request requestId: d7a2eabc-52d6-4405-9b9e-c462e46fd6eb ResponseBadRequestExample4: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.006 message: Please provide correct values for OrderBy which is "asc" or "desc" requestId: b0ce297c-6244-45b6-9f3b-8297fcb7fcd8 ResponseBadRequestExample5: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.005 message: Missing Values for sort parameter either DataPoint or OrderBy requestId: ba9fb6d4-c3bc-46df-ae94-5508993ed278 ResponseBadRequestExample6: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.007 message: Mismatch values of the dataPoint provided in sort. Please verify the dataPoint from the datapoints node in order to sort requestId: 8d9095fd-caa6-48b1-8622-1e2c3710c210 ResponseBadRequestExample7: summary: Required Parameter is Missing from Request Input value: statusCode: 400 errorCode: 400.investmentList.004 message: Invalid datapoints companyGrade.profitaityGrade, legalName. Please send the name correctly requestId: e08f8bbc-f5f5-4587-a65a-41e7d056a50c RequestRetrieveInvestmentListExample1: summary: "Use Case: Performance Watchlist" description: |- "I want to compare YTD, 1Y, 3Y, 5Y returns and see as-of dates." **Typical Fields** - **Reference** - Name - Ticker - ISIN - Asset Type - Currency - **Daily Returns** - Return Date - 1 Day Return - 1 Week Return - 1 Month Return - Year to Date Return - 1 Year Return - **Trailing Return** - As Of Date - 1 Month Return - 3 Month Return - 6 Month Return - 1 Year Return - 3 Year Return - 5 Year Return - **Month End Trailing Performance** (optional) - Return Date - 1 Year Return - 3 Year Annualised Return - 5 Year Annualised Return value: investments: - id: 0P000000YF - id: 0P000000YD - id: 0P000000YB - id: 0P000000YA - id: 0P000000W8 dataPoints: - basicReference.name - basicReference.ticker - instrumentIdentifiers.isin - reference.assetType - reference.currency - dailyReturnsMostRecent.returnDateDaily - dailyReturnsMostRecent.totalRet1DayDaily - dailyReturnsMostRecent.totalRet1WkDaily - dailyReturnsMostRecent.totalRet1MoDaily - dailyReturnsMostRecent.totalRetYtdDaily - dailyReturnsMostRecent.totalRet1YrDaily - trailingReturn.trailingReturnAsOfDate - trailingReturn.trailing1MonthReturn - trailingReturn.trailing3MonthReturn - trailingReturn.trailing6MonthReturn - trailingReturn.trailing1YearReturn - trailingReturn.trailing3YearReturn - trailingReturn.trailing5YearReturn - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.returnDateMoEnd - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd3YrMoEnd - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetAnnlzd5YrMoEnd RequestRetrieveInvestmentListExample2: summary: "Use Case: Diversification / Exposure Watchlist" description: >- “I want to compare what funds are exposed to: equity/bond mix, regions, sectors, market cap." **Typical Fields** - **Reference** - Fund Legal Name - Global Category - **Asset Allocation Mix** - Equity Percent - Bond Percent - Cash Percent - Other Percent - **Country & Regional Exposure** - United States Percent Long Rescaled - Greater Europe Percent Long Rescaled - Greater Asia Percent Long Rescaled - Emerging Percent Long Rescaled - **Market Cap Breakdown** - Market Cap Large Percent Long Rescaled - Market Cap Small Percent Long Rescaled - Market Cap Mid Percent Long Rescaled - **Sector Exposure** - Technology - Healthcare value: investments: - id: IE00B4L5Y983 - id: LU0996182563 dataPoints: - basicReference.fundLegalName - basicReference.isin - morningstarCategory.globalCategory - assetAllocationBreakdown.assetAllocEquityPercNet - assetAllocationBreakdown.assetAllocBondPercNet - assetAllocationBreakdown.assetAllocCashPercNet - assetAllocationBreakdown.assetAllocOtherPercNet - countryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaled - marketCapitalBreakdown.marketCapLargePercLongRescaled - marketCapitalBreakdown.marketCapMidPercLongRescaled - marketCapitalBreakdown.marketCapSmallPercLongRescaled - morningstarEquitySectorsBreakdown.equityEconSectorTechnologyPercLongRescaled - morningstarEquitySectorsBreakdown.equityEconSectorFinancialServicesPercLongRescaled - morningstarEquitySectorsBreakdown.equityEconSectorHealthcarePercLongRescaled RequestRetrieveInvestmentListExample3: summary: "Use Case: Risk & Volatility Watchlist" description: >- "I want to see volatility, beta, r-squared, Sharpe/Sortino, tracking error." **Typical Fields** - **Reference** - Name - ISIN - Asset Type - Currency - **Daily Standard Deviation** - As Of Date - Standard Deviation 252 Day - Standard Deviation 756 Day - **Monthly Standard Deviation** - As Of Date - Standard Deviation 36 Month - Standard Deviation 60 Month - **Risk Statistics** - Beta 3 Year - R-Squared 3 Year - Sortino Ratio 3 Year - Information Ratio 3 Year - Tracking Error 3 Year - Upside Capture Ratio 3 Year - Downside Capture Ratio 3 Year - **Risk-Adjusted Metrics** - Sharpe Ratio 3 Year value: investments: - id: US90214Q1058 - id: US5949181045 dataPoints: - basicReference.name - instrumentIdentifiers.isin - reference.assetType - reference.currency - dailyStandardDeviation.dailyStandardDeviationAsOfDate - dailyStandardDeviation.standardDeviation252Day - dailyStandardDeviation.standardDeviation756Day - monthlyStandardDeviation.asOfDate - monthlyStandardDeviation.standardDeviation36Month - monthlyStandardDeviation.standardDeviation60Month - riskStatistics.beta3YrMoEnd - riskStatistics.rSquared3YrMoEnd - derivedStatsIEMptCurrent.sharpeRatio3YrMoEnd - riskStatistics.sortinoRatio3YrMoEnd - riskStatistics.informationRatio3YrMoEnd - riskStatistics.trackingError3YrMoEnd - riskStatistics.upsideCaptureRatio3YrMoEnd - riskStatistics.downsideCaptureRatio3YrMoEnd RequestRetrieveInvestmentListExample4: summary: "Use Case: Equity Valuation Watchlist" description: |- "I want valuation ratios + quantitative fair value anchors." **Typical Fields** - **Reference** - Standard Name - ISIN - Currency - Market Sector Code - Market Segment Code - **Price** - Close Price - Close Price Datetime - Percent Change - **Price Multiples** - Price to Earnings Ratio - Price to Book Ratio - Price to Sales Ratio - Price to Cash Flow Ratio - Price to Free Cash Flow Ratio - **Enterprise Value** - Enterprise Value - Enterprise Value to EBITDA Ratio - Enterprise Value to Revenue Ratio - **Quantitative Ratings** - Price to Fair Value - Valuation Label - **Quantitative Fair Values** - Fair Value - Fair Value Date value: investments: - id: US0378331005 - id: US5949181045 dataPoints: - companyInformation.standardName - instrumentIdentifiers.isin - reference.currency - reference.marketSectorCode - reference.marketSegmentCode - closePrice.closePrice - closePrice.closePriceDatetime - performanceStatistics.percentChange - priceMultiples.priceToEarningsRatio - priceMultiples.priceToBookRatio - priceMultiples.priceToSalesRatio - priceMultiples.priceToCashFlowRatio - priceMultiples.priceToFreeCashFlowRatio - enterpriseValueCalculations.enterpriseValue - enterpriseValueCalculations.enterpriseValueToEbitdaRatio - enterpriseValueCalculations.enterpriseValueToRevenueRatio - quantitativeRatings.quantitativePriceToFairValue - quantitativeRatings.quantitativeValuationLabel - quantitativeFairValues.quantitativeFairValue - quantitativeFairValues.quantitativeFairValueDate RequestRetrieveInvestmentListExample5: summary: "Use Case: Fund Due Diligence Watchlist" description: >- "I want to shortlist funds based on what they are, fees, AUM, and manager." **Typical Fields** - **Reference** - Fund Legal Name - ISIN - Investment Type - Domicile - Inception Date - Base Currency - **Fund Attributes** - Actively Managed - Index Fund - Open for Investment - **Fees** - Total Expense Ratio - Gross Expense Ratio - Net Expense Ratio - Fee Level - **Net Assets** - Net Assets Date - Fund Size - **Manager** - Manager Name - Manager Tenure Average - **Month End Trailing Performance** (optional) - Year to Date Return - 1 Year Return value: investments: - id: IE00B4L5Y983 - id: LU0996182563 dataPoints: - basicReference.fundLegalName - basicReference.isin - basicReference.investmentType - basicReference.domicile - basicReference.inceptionDate - basicReference.baseCurrency - fundAttributes.activelyManaged - fundAttributes.indexFund - fundAttributes.openForInvestment - annualReportFeesAndFinancialsMostRecent.totalExpenseRatio - prospectusFees.prospectusGrossExpenseRatio - prospectusFees.prospectusNetExpenseRatio - feeLevelRanks.morningstarFeeLevelBroad - netAssetsMonthEndMostRecent.netAssetsDate - netAssetsMonthEndMostRecent.fundSize - managerBioAndDetailsMostRecent.managerName - managerBioAndDetailsMostRecent.managerTenureAverage - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRetYtdMoEnd - monthEndTrailingPerformanceMonthEndAndQuarterEndMostRecent.totalRet1YrMoEnd RequestRetrieveInvestmentListExample6: summary: "Scenario: Request Limits Maximum Data Points - 50" description: A maximum of 50 data points can be sent in a single request. value: dataPoints: - basicReference.baseCurrency - basicReference.countryAvailableForSale - basicReference.domicile - basicReference.firmName - basicReference.fundCode - basicReference.fundid - basicReference.fundLegalName - basicReference.inceptionDate - basicReference.investmentType - basicReference.isin - basicReference.legalName - basicReference.name - basicReference.portfolioDate - basicReference.primaryShare - basicReference.shareClassType - basicReference.ticker - bestAndWorstRollingReturns.best3MoAsOfDateQtrEnd - bestAndWorstRollingReturns.best3MoRetInceptionQtrEnd - bestAndWorstRollingReturns.worst3MoAsOfDateQtrEnd - bestAndWorstRollingReturns.worst3MoRetInceptionQtrEnd - companyGrade.growthGrade - companyGrade.profitabilityGrade - companyInformation.cik - companyInformation.companyId - companyInformation.companyStatus - companyInformation.domicileCountryCode - companyInformation.globalTemplateIndustryTemplateCode - companyInformation.legalName - companyInformation.legalNameLanguageCode - companyInformation.lei - companyInformation.morningstarIndustryCode - companyInformation.morningstarIndustryGroupCode - companyInformation.morningstarSectorCode - companyInformation.operationStatus - companyInformation.shortName - companyInformation.standardName - companyInformation.webAddress - countryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaled - dailyDividendResidualRiskAndReturnSensitivity.beta1260Day - dailyReturnsMostRecent.returnDateDaily - dailyReturnsMostRecent.totalRet1DayDaily - dailyReturnsMostRecent.totalRet1MoDaily - dailyReturnsMostRecent.totalRet1WkDaily - dailyReturnsMostRecent.totalRet1YrDaily - dailyReturnsMostRecent.totalRet3MoDaily - dailyReturnsMostRecent.totalRet6MoDaily - dailyReturnsMostRecent.totalRetAnnlzd10YrDaily investments: - id: 0P0000000F - id: 0P0000001J - id: 0P0000002I - id: 0P0000003G - id: 0P0000004E - id: 0P0000007F - id: 0P0000008M - id: 0P0000008R - id: 0P000000GB - id: 0P000000GJ - id: 0P000000JI - id: 0P000000T0 - id: 0P000000V5 - id: 0P000000VK - id: 0P000000VZ - id: 0P000000W5 - id: 0P000000W7 - id: 0P000000W8 - id: 0P000000W9 - id: 0P000000WF - id: 0P000000WH RequestRetrieveInvestmentListExample7: summary: "Scenario - Request Limits: Maximum Investments - 100" description: A maximum of 100 investment IDs can be sent in a single request. value: dataPoints: - companyGrade.growthGrade - companyGrade.profitabilityGrade - companyInformation.cik - companyInformation.companyId - companyInformation.companyStatus - companyInformation.domicileCountryCode - companyInformation.globalTemplateIndustryTemplateCode - companyInformation.legalName - companyInformation.legalNameLanguageCode - companyInformation.lei - companyInformation.morningstarIndustryCode - companyInformation.morningstarIndustryGroupCode - companyInformation.morningstarSectorCode - companyInformation.operationStatus - companyInformation.shortName - companyInformation.standardName - companyInformation.webAddress - countryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaled - dailyDividendResidualRiskAndReturnSensitivity.beta1260Day - dailyReturnsMostRecent.returnDateDaily - dailyReturnsMostRecent.totalRet1DayDaily - dailyReturnsMostRecent.totalRet1MoDaily - dailyReturnsMostRecent.totalRet1WkDaily - dailyReturnsMostRecent.totalRet1YrDaily - dailyReturnsMostRecent.totalRet3MoDaily - dailyReturnsMostRecent.totalRet6MoDaily - dailyReturnsMostRecent.totalRetAnnlzd10YrDaily investments: - id: 0P0000000F - id: 0P0000001J - id: 0P0000002I - id: 0P0000003G - id: 0P0000004E - id: 0P0000007F - id: 0P0000008M - id: 0P0000008R - id: 0P000000GB - id: 0P000000GJ - id: 0P000000JI - id: 0P000000T0 - id: 0P000000V5 - id: 0P000000VK - id: 0P000000VZ - id: 0P000000W5 - id: 0P000000W7 - id: 0P000000W8 - id: 0P000000W9 - id: 0P000000WF - id: 0P000000WH - id: 0P000000WK - id: 0P000000WN - id: 0P000000WO - id: 0P000000WR - id: 0P000000WZ - id: 0P000000X0 - id: 0P000000X1 - id: 0P000000X3 - id: 0P000000X6 - id: 0P000000X9 - id: 0P000000XA - id: 0P000000XD - id: 0P000000XE - id: 0P000000XH - id: 0P000000XI - id: 0P000000XJ - id: 0P000000XL - id: 0P000000XO - id: 0P000000XQ - id: 0P000000XT - id: 0P000000XU - id: 0P000000XW - id: 0P000000XX - id: 0P000000XY - id: 0P000000XZ - id: 0P000000Y0 - id: 0P000000Y1 - id: 0P000000Y2 - id: 0P000000Y3 - id: 0P000000Y4 - id: 0P000000Y5 - id: 0P000000Y6 - id: 0P000000Y7 - id: 0P000000Y8 - id: 0P000000Y9 - id: 0P000000YA - id: 0P000000YB - id: 0P000000YC - id: 0P000000YD - id: 0P000000YE - id: 0P000000YF - id: 0P000000YG - id: 0P000000YH - id: 0P000000YI - id: 0P000000YJ - id: 0P000000YK - id: 0P000000YL - id: 0P000000YM - id: 0P000000YN - id: 0P000000YO - id: 0P000000YP - id: 0P000000YQ - id: 0P000000YR - id: 0P000000YS - id: 0P000000YT - id: 0P000000YU - id: 0P000000YV - id: 0P000000YW - id: 0P000000YX - id: 0P000000YY - id: 0P000000YZ - id: 0P000000Z0 - id: 0P000000Z1 - id: 0P000000Z2 - id: 0P000000Z3 - id: 0P000000Z4 - id: 0P000000Z5 - id: 0P000000Z6 - id: 0P000000Z7 - id: 0P000000Z8 - id: 0P000000Z9 - id: 0P000000ZA - id: 0P000000ZB - id: 0P000000ZC - id: 0P000000ZD - id: 0P000000ZE - id: 0P000000ZF - id: 0P000000ZG - id: 0P000000ZH RequestRetrieveInvestmentListExample8: summary: "Scenario: Maximum Sort Fields - 2" description: Results are sorted by `performanceId` in ascending order by default. You can override the default settings by specifing up to two fields to sort results by. value: dataPoints: - companyGrade.growthGrade - companyGrade.profitabilityGrade - companyInformation.cik - companyInformation.companyId - companyInformation.companyStatus - companyInformation.domicileCountryCode - companyInformation.globalTemplateIndustryTemplateCode - companyInformation.legalName - companyInformation.legalNameLanguageCode - companyInformation.lei - companyInformation.morningstarIndustryCode - companyInformation.morningstarIndustryGroupCode - companyInformation.morningstarSectorCode - companyInformation.operationStatus - companyInformation.shortName - companyInformation.standardName - companyInformation.webAddress - countryAndRegionalExposureBreakdown.equityRegionEmergingPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterAsiaPercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionGreaterEuropePercLongRescaled - countryAndRegionalExposureBreakdown.equityRegionUnitedStatesPercLongRescaled - dailyDividendResidualRiskAndReturnSensitivity.beta1260Day - dailyReturnsMostRecent.returnDateDaily - dailyReturnsMostRecent.totalRet1DayDaily - dailyReturnsMostRecent.totalRet1MoDaily - dailyReturnsMostRecent.totalRet1WkDaily - dailyReturnsMostRecent.totalRet1YrDaily - dailyReturnsMostRecent.totalRet3MoDaily - dailyReturnsMostRecent.totalRet6MoDaily - dailyReturnsMostRecent.totalRetAnnlzd10YrDaily investments: - id: 0P0000000F - id: 0P0000001J - id: 0P0000002I - id: 0P0000003G - id: 0P0000004E - id: 0P0000007F - id: 0P0000008M - id: 0P0000008R - id: 0P000000GB - id: 0P000000GJ - id: 0P000000JI - id: 0P000000T0 - id: 0P000000V5 - id: 0P000000VK - id: 0P000000VZ - id: 0P000000W5 - id: 0P000000W7 - id: 0P000000W8 - id: 0P000000W9 - id: 0P000000WF - id: 0P000000WH sort: - dataPoint: companyInformation.companyId orderBy: asc - dataPoint: dailyReturnsMostRecent.totalRet1DayDaily orderBy: desc securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: >- JWT obtained from `POST /token/oauth`. Send it on every request as `Authorization: Bearer `. Reuse the token for up to 60 minutes, then request a new one. ```