---
title: "Get Asset Allocation Breakdown view"
url: "https://developer-beta.morningstar.com/apis/investment-details-api/versions/1101e487-2040-43e8-8548-06647294be56/operations/getAssetAllocationBreakdownPackage"
---

> Full API specification: https://developer-beta.morningstar.com/apis/investment-details-api/versions/1101e487-2040-43e8-8548-06647294be56.md

# Get Asset Allocation Breakdown view

`GET` `/direct-web-services/v1/investments/{id}/asset-allocation-breakdown`

Operation ID: `getAssetAllocationBreakdownPackage`

Most recent data supported.

## Path parameters

- `id` (string, required) - Specifies the investment to query. Morningstar Performance ID is the default identifer for the API. Use the Universe API to retrieve Performance IDs for investments in your entitled universe.

## Query parameters

- `idType` (string, optional) - Specifies the type of the value passed in the `id` parameter. Morningstar Performance ID is the default identifer for the API. Use the Universe API to retrieve Performance IDs for investments in your entitled universe.
- `baseCurrency` (string, optional) - Base currency to use for investment lookup. Accepts 3‑character ISO 4217 currency codes.
- `domicile` (string, optional) - Domicile to use for investment lookup. Accepts 3-character ISO 3166-1 country codes.
- `exchangeCountry` (string, optional) - Exchange country to use for investment lookup. Accepts 3-character ISO 3166-1 country codes.
- `exchangeId` (string, optional) - Exchange identifier to use for investment lookup.

## Responses

- `200` - OK
- `400` - Bad Request
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Investment Details 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/investments/{id}/asset-allocation-breakdown:
    get:
      summary: Get Asset Allocation Breakdown view
      parameters:
        - name: id
          in: path
          description: >-
            
            Specifies the investment to query. 

            Morningstar Performance ID is the default identifer for the API. Use
            the Universe API to retrieve Performance IDs for investments in your
            entitled universe.
          required: true
          schema:
            type: string
            example: 0P00000046
          examples:
            performanceId:
              summary: Morningstar Performance ID
              value: 0P00000046
            isin:
              summary: ISIN
              value: US0042391096
        - name: idType
          in: query
          description: >-
            Specifies the type of the value passed in the `id` parameter.

            Morningstar Performance ID is the default identifer for the API. Use
            the Universe API to retrieve Performance IDs for investments in your
            entitled universe.
          schema:
            enum:
              - performanceId
              - isin
              - securityId
              - cusip
              - tradingSymbol
              - fundCode
              - msid
            type: string
            default: performanceId
        - name: baseCurrency
          in: query
          description: Base currency to use for investment lookup. Accepts 3‑character ISO
            4217 currency codes.
          schema:
            type: string
          examples:
            baseCurrencyExample1:
              summary: US Dollar
              value: USD
            baseCurrencyExample2:
              summary: Swiss Franc
              value: CHF
        - name: domicile
          in: query
          description: Domicile to use for investment lookup. Accepts 3-character ISO
            3166-1 country codes.
          schema:
            type: string
          examples:
            domicileExample1:
              summary: CAN (Canada)
              value: CAN
            domicileExample2:
              summary: JPN (Japan)
              value: JPN
            domicileExample3:
              summary: USE (United States)
              value: USA
        - name: exchangeCountry
          in: query
          description: Exchange country to use for investment lookup. Accepts 3-character
            ISO 3166-1 country codes.
          schema:
            type: string
          examples:
            exchangeCountryExample1:
              summary: CAN (Canada)
              value: CAN
            exchangeCountryExample2:
              summary: JPN (Japan)
              value: JPN
            exchangeCountryExample3:
              summary: USA (USA)
              value: USA
        - name: exchangeId
          in: query
          description: Exchange identifier to use for investment lookup.
          schema:
            type: string
            externalDocs:
              description: List of exchange IDs.
              url: https://developer.morningstar.com/content/hidden-from-navigation/DwsIdLookUpExchangeIds.xlsx
          examples:
            exchangeIdExample1:
              summary: NASDAQ - ALL Markets (NAS)
              value: EX$$$$XNAS
            exchangeIdExample2:
              summary: London Stock Exchange (LSE)
              value: EX$$$$XLON
      description: Most recent data supported.
      operationId: getAssetAllocationBreakdownPackage
      tags:
        - Investment Details
      responses:
        "200":
          $ref: "#/components/responses/ResponseAssetAllocationBreakdown"
        "400":
          $ref: "#/components/responses/ResponseBadRequest"
        "500":
          $ref: "#/components/responses/ResponseInternalServerError"
      x-cpqId: 66
security:
  - Bearer: []
components:
  responses:
    ResponseAssetAllocationBreakdown:
      description: OK
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ResponseAssetAllocationBreakdown"
    ResponseBadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/OutputErrorDetails"
    ResponseInternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/OutputErrorDetails"
  schemas:
    ResponseAssetAllocationBreakdown:
      type: object
      properties:
        assetAllocationBreakdown:
          $ref: "#/components/schemas/OutputAssetAllocationBreakdown"
        identifiers:
          $ref: "#/components/schemas/OutputIdentifiers"
        metadata:
          $ref: "#/components/schemas/OutputMetadata"
    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
      title: OutputErrorDetails
    OutputAssetAllocationBreakdown:
      type: object
      properties:
        assetAllocationEconomicExposureCurrencyLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureCurrencyNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureCurrencyShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureDate:
          type: string
          description: ""
          nullable: true
        assetAllocationEconomicExposureEquityLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureEquityNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureEquityShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureFixedIncomeLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureFixedIncomeNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureFixedIncomeShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureOtherLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureOtherNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationEconomicExposureOtherShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocationSurveyDate:
          type: string
          description: ""
          nullable: true
        assetAllocBondPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocBondPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocBondPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocBondPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocCashPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocCashPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocCashPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocCashPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocConvBondPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsBondPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsBondPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsBondPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsBondPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocNonUsEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocOtherPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocOtherPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocOtherPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocOtherPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocPrefStockPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocRescalingFactorLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsBondPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsBondPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsBondPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsBondPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocUsEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCanadianEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCanadianEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCanadianEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCanadianEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCashPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCashPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCashPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocCashPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocFixedIncomePercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocFixedIncomePercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocFixedIncomePercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocFixedIncomePercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocInternationalEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocInternationalEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocInternationalEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocInternationalEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocOtherPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocOtherPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocOtherPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocOtherPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocUSEquityPercLong:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocUSEquityPercLongRescaled:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocUSEquityPercNet:
          type: number
          description: ""
          format: double
          nullable: true
        canAssetAllocUSEquityPercShort:
          type: number
          description: ""
          format: double
          nullable: true
        cashAndEquivalentsAllocationTarget:
          type: number
          description: ""
          format: double
          nullable: true
        cashAndEquivalentsAllocationTargetMaximum:
          type: number
          description: ""
          format: double
          nullable: true
        cashAndEquivalentsAllocationTargetMinimum:
          type: number
          description: ""
          format: double
          nullable: true
        cashAus:
          type: number
          description: ""
          format: double
          nullable: true
        chinaAPerc:
          type: number
          description: ""
          format: double
          nullable: true
        domesticEquityAus:
          type: number
          description: ""
          format: double
          nullable: true
        domesticFixedInterestAus:
          type: number
          description: ""
          format: double
          nullable: true
        domesticListedPropertyAus:
          type: number
          description: ""
          format: double
          nullable: true
        equityAllocationTarget:
          type: number
          description: ""
          format: double
          nullable: true
        equityAllocationTargetMaximum:
          type: number
          description: ""
          format: double
          nullable: true
        equityAllocationTargetMinimum:
          type: number
          description: ""
          format: double
          nullable: true
        fixedIncomeAllocationTarget:
          type: number
          description: ""
          format: double
          nullable: true
        fixedIncomeAllocationTargetMaximum:
          type: number
          description: ""
          format: double
          nullable: true
        fixedIncomeAllocationTargetMinimum:
          type: number
          description: ""
          format: double
          nullable: true
        internationalEquityAus:
          type: number
          description: ""
          format: double
          nullable: true
        internationalFixedInterestAus:
          type: number
          description: ""
          format: double
          nullable: true
        internationalListedPropertyAus:
          type: number
          description: ""
          format: double
          nullable: true
        maximumDrawdownTarget:
          type: number
          description: ""
          format: double
          nullable: true
        otherAllocationTarget:
          type: number
          description: ""
          format: double
          nullable: true
        otherAllocationTargetMaximum:
          type: number
          description: ""
          format: double
          nullable: true
        otherAllocationTargetMinimum:
          type: number
          description: ""
          format: double
          nullable: true
        otherAus:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentBondPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentCashAndMoneyMarketPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentClosedEndFundPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentExchangeTradedProductPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentInstitutionalInvestmentPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentMiscellaneousSecuritiesPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentOpenEndFundPercent:
          type: number
          description: ""
          format: double
          nullable: true
        underlyingInstrumentStockPercent:
          type: number
          description: ""
          format: double
          nullable: true
        unlistedPropertyAus:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationCommodityPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationEffectiveDate:
          type: string
          description: ""
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationEmergingBondPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationEmergingEquityPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationJapaneseBondPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationJapaneseCashPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationJapaneseEquityPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationJapaneseReitPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationOthersPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationWorldBondPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationWorldEquityPercent:
          type: number
          description: ""
          format: double
          nullable: true
        japanSurveyBasedPrimaryAssetAllocationWorldReitPercent:
          type: number
          description: ""
          format: double
          nullable: true
        privateAllocationPercentLong:
          type: number
          description: ""
          format: double
          nullable: true
        privateAllocationPercentNet:
          type: number
          description: ""
          format: double
          nullable: true
        privateAllocationPercentShort:
          type: number
          description: ""
          format: double
          nullable: true
        assetAllocOtherPercLongRescaledVa:
          type: number
          description: ""
          format: double
          nullable: true
      additionalProperties: false
      title: OutputAssetAllocationBreakdown
      description: All fields are nullable. Empty or `null` value fields are not returned.
    OutputIdentifiers:
      type: object
      properties:
        performanceId:
          type: string
          nullable: true
        securityId:
          type: string
          nullable: true
        cusip:
          type: string
          nullable: true
        isin:
          type: string
          nullable: true
        sedol:
          type: string
          nullable: true
        tradingSymbol:
          type: string
          nullable: true
        fundCode:
          type: string
          nullable: true
        msid:
          type: string
          nullable: true
        ticker:
          type: string
          nullable: true
      additionalProperties: false
      title: OutputIdentifiers
      description: All fields are nullable. Empty or `null` value fields are not returned.
    OutputMetadata:
      type: object
      properties:
        requestId:
          type: string
          nullable: true
        time:
          type: string
          format: date-time
          readOnly: true
        portfolioDate:
          type: string
          nullable: true
        portfolioCurrency:
          type: string
          nullable: true
        messages:
          type: array
          items:
            $ref: "#/components/schemas/OutputMetadataMessages"
          nullable: true
      additionalProperties: false
      title: OutputMetadata
      description: All fields are nullable. Empty or `null` value fields are not returned.
    OutputMetadataMessages:
      type: object
      properties:
        type:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        investments:
          type: array
          items:
            $ref: "#/components/schemas/OutputInvalidInvestments"
          nullable: true
        message:
          type: string
          nullable: true
      additionalProperties: false
      title: OutputMetadataMessages
      description: All fields are nullable. Empty or `null` value fields are not returned.
    OutputInvalidInvestments:
      type: object
      properties:
        id:
          type: string
          nullable: true
        idType:
          type: string
          nullable: true
        status:
          type: string
          nullable: true
        datapointId:
          type: array
          items:
            type: string
          nullable: true
        customDatapoints:
          type: array
          items:
            type: string
          nullable: true
        errorCode:
          type: string
          nullable: true
        performanceId:
          type: string
          description: Performance ID (if not passed in request).
          nullable: true
        companyId:
          type: string
          description: Company ID (if not passed in request).
          nullable: true
        baseCurrency:
          type: string
          description: Input base currency used to look up Investment identifier
          nullable: true
        domicile:
          type: string
          description: Input domicile used to look up Investment identifier.
          nullable: true
        exchangeCountry:
          type: string
          description: Input exchange country used to look up Investment identifier.
          nullable: true
        exchangeId:
          type: string
          description: Input exchange id used to look up Investment identifier.
          nullable: true
      additionalProperties: false
      title: OutputInvalidInvestments
      description: All fields are nullable. Empty or `null` value fields are not returned.
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: "JWT obtained from `POST /token/oauth`. Send it on every request as
        `Authorization: Bearer <token>`. Reuse the token for up to 60 minutes,
        then request a new one."
```