---
title: "API Inputs"
description: "Input fields for the Universe API."
url: "https://developer-beta.morningstar.com/universe-api/api-inputs"
image: "https://developer-beta.morningstar.com/_og/d/c_Ocean.takumi,title_~QVBJIElucHV0cyB8IFVuaXZlcnNlIEFQSQ,description_Input+fields+for+the+Universe+API.,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDAwMDAifX19,p_Ii91bml2ZXJzZS1hcGkvYXBpLWlucHV0cyI,s_PjY22Yw5SC9_6mPm.png"
---

-   [APIs](https://developer-beta.morningstar.com/apis)
-   [API Catalog](https://developer-beta.morningstar.com/api-catalog)
-   [API Assistant MCP Server](https://developer-beta.morningstar.com/api-assistant-mcp)
-   [Guides](https://developer-beta.morningstar.com/api-guides)
-   [Trial Access](https://developer-beta.morningstar.com/trial-access)

# Universe API

Retrieve investment identifiers in your entitled universe.

# API Inputs

[View Markdown](https://developer-beta.morningstar.com/universe-api/api-inputs.md)[Download Markdown](https://developer-beta.morningstar.com/universe-api/api-inputs.md)

## [Request Inputs](#request-inputs)

These inputs apply to the `GET /direct-web-services/v1/investments` request: the `Authorization` header, and the query parameters that choose the investment type, the filters and the page.

### [Authorization](#authorization)

| Attribute       | Value                                               |
| :-------------- | :-------------------------------------------------- |
| Type            | Header                                              |
| Data Type       | string                                              |
| Possible Values | Bearer {token}, where the token is a JSON Web Token |
| Example         | Bearer eyJhbGciOi...                                |

Specifies the token that authorizes the request. Required. For more information about getting a token, see the [Authentication](https://developer-beta.morningstar.com/api-authentication) page.

### [countryAvailableForSaleCode](#countryavailableforsalecode)

| Attribute       | Value                                |
| :-------------- | :----------------------------------- |
| Type            | Query Parameter                      |
| Data Type       | string                               |
| Possible Values | 3-character ISO 3166-1 country codes |
| Example         | USA                                  |

Primary filter for managed investments. Filters results by country available for sale. Use either this or `domicileCode`, not both.

### [domicileCode](#domicilecode)

| Attribute       | Value                                |
| :-------------- | :----------------------------------- |
| Type            | Query Parameter                      |
| Data Type       | string                               |
| Possible Values | 3-character ISO 3166-1 country codes |
| Example         | USA                                  |

Primary filter for managed investments. Filters results by domicile. Use either this or `countryAvailableForSaleCode`, not both.

### [exchange](#exchange)

| Attribute       | Value                             |
| :-------------- | :-------------------------------- |
| Type            | Query Parameter                   |
| Data Type       | string                            |
| Possible Values | An exchange ID. See Filter Values |
| Example         | EX$$$$AMXO                        |

Secondary filter for managed investments. Filters results by exchange.

### [exchangeCode](#exchangecode)

| Attribute       | Value                                   |
| :-------------- | :-------------------------------------- |
| Type            | Query Parameter                         |
| Data Type       | string                                  |
| Possible Values | An exchange code from your entitlements |
| Example         | XPAR                                    |

Primary filter for equities. Filters results by exchange code.

### [fundLegalStructureName](#fundlegalstructurename)

| Attribute       | Value             |
| :-------------- | :---------------- |
| Type            | Query Parameter   |
| Data Type       | string            |
| Possible Values | See Filter Values |
| Example         | 40                |

Secondary filter for managed investments. Filters results by fund legal structure.

### [investmentType](#investmenttype)

| Attribute       | Value             |
| :-------------- | :---------------- |
| Type            | Query Parameter   |
| Data Type       | string            |
| Possible Values | See Filter Values |
| Example         | BD                |

Secondary filter for managed investments. Filters results by investment type.

### [pageSize](#pagesize)

| Attribute       | Value                |
| :-------------- | :------------------- |
| Type            | Query Parameter      |
| Data Type       | integer              |
| Possible Values | 1 to 50. Default: 50 |
| Example         | 25                   |

Specifies the number of records per page.

### [paginationTokenNext](#paginationtokennext)

| Attribute       | Value                                                    |
| :-------------- | :------------------------------------------------------- |
| Type            | Query Parameter                                          |
| Data Type       | string                                                   |
| Possible Values | The paginationTokenNext value from the previous response |
| Example         | CJjVEBoTOhE...                                           |

Specifies the token used to retrieve the next page of results. Use the same filters as the request that returned the token.

### [paginationTokenPrevious](#paginationtokenprevious)

| Attribute       | Value                                                        |
| :-------------- | :----------------------------------------------------------- |
| Type            | Query Parameter                                              |
| Data Type       | string                                                       |
| Possible Values | The paginationTokenPrevious value from the previous response |
| Example         | CLf5DxoROg9...                                               |

Specifies the token used to retrieve the previous page of results.

### [securityType](#securitytype)

| Attribute       | Value             |
| :-------------- | :---------------- |
| Type            | Query Parameter   |
| Data Type       | string            |
| Possible Values | See Filter Values |
| Example         | ST00000001        |

Secondary filter for equities. Filters results by security type.

### [shareClassInformationInvestmentType](#shareclassinformationinvestmenttype)

| Attribute       | Value           |
| :-------------- | :-------------- |
| Type            | Query Parameter |
| Data Type       | string          |
| Possible Values | EQ, DR, PE, UE  |
| Example         | EQ              |

Secondary filter for equities. Filters results by investment type.

### [source](#source)

| Attribute       | Value                                           |
| :-------------- | :---------------------------------------------- |
| Type            | Query Parameter                                 |
| Data Type       | string                                          |
| Possible Values | equities, managedInvestments. Default: equities |
| Example         | managedInvestments                              |

Specifies the investment type to query.

### [universe](#universe)

| Attribute       | Value                                                 |
| :-------------- | :---------------------------------------------------- |
| Type            | Query Parameter                                       |
| Data Type       | string                                                |
| Possible Values | The name of a custom universe set up for your account |
| Example         | MY_EQUITIES_ABC                                       |

Filters results to a custom universe. A custom universe can be retrieved in full, or narrowed with filters.