---
title: "OutputInvestment"
url: "https://developer-beta.morningstar.com/apis/equities-screener-api/versions/6a741807-eba1-4fa3-bcc8-1d4904910e0a/schemas/OutputInvestment"
---

> Full API specification: https://developer-beta.morningstar.com/apis/equities-screener-api/versions/6a741807-eba1-4fa3-bcc8-1d4904910e0a.md

# OutputInvestment

Data points and values returned for a single result. Keys are data point names in the format `<dataGroup>.<fieldName>`; values depend on the data type of the data point. `instrumentIdentifiers.performanceId` is always returned. Data points with no value may be omitted.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Equities Screener 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:
    OutputDataPointValue:
      title: OutputDataPointValue
      description: Value of a data point. Scalar data points return a string, number,
        integer, or boolean (dates are returned as `YYYY-MM-DD` strings). Data
        points where `isCodeMapped` is true return an `OutputCodeMappedValue`
        object, or an array of these objects for multi-value data points.
      anyOf:
        - type: string
        - type: number
        - type: integer
        - type: boolean
        - type: "null"
        - $ref: "#/components/schemas/OutputCodeMappedValue"
        - type: array
          items:
            $ref: "#/components/schemas/OutputCodeMappedValue"
    OutputCodeMappedValue:
      title: OutputCodeMappedValue
      description: "Value of a code-mapped data point: the underlying code and its
        display value."
      type: object
      properties:
        code:
          description: Code. Depending on the data point, a string, number, integer, or
            boolean.
          anyOf:
            - type: string
            - type: number
            - type: integer
            - type: boolean
            - type: "null"
        value:
          description: Display value for the code. Language-dependent data points use
            `languageId`.
          type:
            - string
            - "null"
      additionalProperties: false
      example:
        code: USD
        value: US Dollar
    OutputInvestment:
      title: OutputInvestment
      description: Data points and values returned for a single result. Keys are data
        point names in the format `<dataGroup>.<fieldName>`; values depend on
        the data type of the data point. `instrumentIdentifiers.performanceId`
        is always returned. Data points with no value may be omitted.
      type: object
      propertyNames:
        description: Data point name in the format `<dataGroup>.<fieldName>`. Retrieve
          valid values programmatically via `GET
          /direct-web-services/v1/screeners/equities/data-points`, or browse the
          full reference in the data dictionary.
        type: string
        externalDocs:
          description: Data dictionary (Excel)
          url: https://developer.morningstar.com/content/hidden-from-navigation/ScreenerEquitiesDataDictionary.xlsx
      additionalProperties:
        $ref: "#/components/schemas/OutputDataPointValue"
      example:
        instrumentIdentifiers.performanceId: 0P0001VK71
        shareClassInformation.symbol: MSES
        shareClassInformation.investmentStatus: 1
        marketCapital.asOfDate: 2025-10-02
        trailingReturn.trailing10YearReturn: 12.45
        companyInformation.sic: 6719
```
