The Universe API is a utility to retrieve reference information for the investments in your entitled universe.
Overview
Use the Universe API to:
- Get a custom universe.
- Get universe entitlements.
- Filter entitled universe and retrieve paginated results.
Core Concepts
Custom Universe
- A named subset of an account’s full entitled universe.
- A custom universe can be retrieved in full or narrowed further by applying filters.
Primary Filter
- The primary filter is a required prerequisite filter that determines the top-level scope of the results.
- A primary filter must be present before any secondary filter can be applied.
- Only one primary filter can be used per request.
- For equities, the primary filter is
exchangeCode. - For managed investments, use either
countryAvailableForSaleCodeanddomicileCodeas the primary filter.
Secondary Filter
- An optional filter that further narrows results within the scope set by the primary filter.
- Secondary filters cannot be used without a primary filter, but multiple secondary filters can be combined in the same request.
- Currently, secondary filters are supported for equities only.
- For equities, the supported secondary filters are
securityType,shareClassInformationInvestmentType.
Authentication API
- Retrieve tokens required to authorize calls to the API.
- See documentation.
- Server 1:https://www.us-api.morningstar.com
Americas Production
- Server 2:https://www.apac-api.morningstar.com
APAC Production
- Server 3:https://www.eu-api.morningstar.com
EMEA Production
Bearer (http)
Obtain a token via the Authentication API’s POST /token/oauth endpoint. Tokens are valid for 60 minutes and reusable across requests.