---
title: "RequestInvestmentDetails"
url: "https://developer-beta.morningstar.com/apis/investment-details-feed-api/versions/bc1f8f4b-464c-40a5-af50-a06cce9f3980/schemas/RequestInvestmentDetails"
---

> Full API specification: https://developer-beta.morningstar.com/apis/investment-details-feed-api/versions/bc1f8f4b-464c-40a5-af50-a06cce9f3980.md

# RequestInvestmentDetails

Request investment details for up to 3 views and 250 investments.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Investment Details Feed 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:
      title: InputInvestment
      description: Investment to query. Investment look up is supported.
      type: object
      required:
        - id
      additionalProperties: false
      properties:
        id:
          type: string
          description: |-
            Specifies the investment identifier to query. Accepts performance
            IDs, ISINs, security IDs, CUSIPs, trading symbols, and Morningstar
            IDs.
        idType:
          type: string
          example: performanceId
          default: performanceId
          enum:
            - performanceId
            - isin
            - fundCode
            - securityId
            - cusip
            - msid
            - tradingSymbol
            - industryCode
        exchangeCountry:
          type: string
          example: USA
          description: |-
            Specifies exchange country used to look up investment. Accepts
            3-character ISO 3166-1 country codes.
          minLength: 3
          maxLength: 3
        domicile:
          type: string
          example: USA
          description: |-
            Specifies domicile used to look up investment. Accepts 3-character
            ISO 3166-1 country codes.
          minLength: 3
          maxLength: 3
        baseCurrency:
          type: string
          example: USD
          description: |-
            Specifies base currency used to look up investment. Accepts
            3-character ISO 4217 currency codes.
        exchangeId:
          type: string
          example: EX$$$$XNAS
          description: Specifies exchange identifier used to look up investment. See the
            data dictionary for full list of accepted values.
          externalDocs:
            description: Investment Details Equities Data Dictionary (Excel)
            url: https://advisor.morningstar.com/Enterprise/VTC/EquityData/InvestmentDetailsAPIEquityDataDictionary.xlsx
    InputView:
      title: InputView
      type: object
      required:
        - viewId
      properties:
        viewId:
          type: string
          description: The view identifier. Standard view ids are package names; a view
            defined for your organisation uses the identifier issued to you.
        viewType:
          type: string
          default: package
          enum:
            - package
            - DDADataset
    RequestInvestmentDetails:
      title: RequestInvestmentDetails
      description: Request investment details for up to 3 views and 250 investments.
      type: object
      required:
        - investments
        - views
      properties:
        investments:
          description: List of investments to query.
          type: array
          items:
            $ref: "#/components/schemas/InputInvestment"
          minItems: 1
          maxItems: 250
        views:
          type: array
          description: List of views.
          items:
            $ref: "#/components/schemas/InputView"
          minItems: 1
          maxItems: 3
        startDate:
          type: string
          format: date
          description: Specifies the start date of a time series. Accepts yyyy-MM-dd.
          nullable: true
          example: 2020-01-25
        endDate:
          type: string
          format: date
          description: Specifies the start date of a time series. Accepts yyyy-MM-dd.
          nullable: true
          example: 2024-01-25
        languageId:
          type: string
          description: Specifies the language to filter results on. Required for
            language-dependent data.
          default: ENG
          enum:
            - ENG
            - SPA
            - FRA
            - DEU
            - ITA
            - JPN
            - CHI
            - ZHO
            - KOR
          x-enumDescriptions:
            ENG: English
            SPA: Spanish
            FRA: French
            DEU: German
            ITA: Italian
            JPN: Japanese
            CHI: Chinese Simplified
            ZHO: Chinese Traditional
            KOR: Korean
          nullable: true
        countryId:
          type: string
          description: Specifies the country to filter results on. Accepts 3-character ISO
            3166-1 country codes. Required for country-dependent data.
          default: USA
          example: CAN
          nullable: true
        regionId:
          type: string
          description: Specifies the region for style box breakpoints.
          nullable: true
          example: "1"
          enum:
            - "1"
            - "2"
            - "3"
            - "4"
            - "5"
            - "6"
            - "7"
          x-enumDescriptions:
            "1": United States
            "2": Canada
            "3": Latin America
            "4": Europe
            "5": Japan
            "6": Australia/New Zealand
            "7": Asia excluding Japan
      additionalProperties: false
```