---
title: "RequestRetrieveInvestmentList"
url: "https://developer-beta.morningstar.com/apis/investment-list-api/versions/90f4a97d-5cec-479b-81cc-6346f8ec5d62/schemas/RequestRetrieveInvestmentList"
---

> Full API specification: https://developer-beta.morningstar.com/apis/investment-list-api/versions/90f4a97d-5cec-479b-81cc-6346f8ec5d62.md

# RequestRetrieveInvestmentList

## 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
components:
  schemas:
    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
    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
```