---
title: "Request Equity Data"
description: "Article describes how to request investment details for equity data using the Investment Details API."
url: "https://developer-beta.morningstar.com/investment-details-api/request-equities"
image: "https://developer-beta.morningstar.com/_og/d/c_Ocean.takumi,title_~UmVxdWVzdCBFcXVpdHkgRGF0YSB8IEludmVzdG1lbnQgRGV0YWlscyBBUEk,description_Article+describes+how+to+request+investment+details+for+equity+data+using+the+Investment+Details+API.,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDAwMDAifX19,p_Ii9pbnZlc3RtZW50LWRldGFpbHMtYXBpL3JlcXVlc3QtZXF1aXRpZXMi,s_tB9Ic3MGTzGvfIgB.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)

# Investment Details API

Get detailed profile data for a single investment, drawing on Morningstar's fundamental, reference, and historical data.

# Request Equity Data

[View Markdown](https://developer-beta.morningstar.com/investment-details-api/request-equities.md)[Download Markdown](https://developer-beta.morningstar.com/investment-details-api/request-equities.md)

This page describes how to request equity data using the Investment Details API.

## [Build Your Request](#build-your-request)

### [1: Select Endpoint](#_1-select-endpoint)

Every request is a `GET` to an endpoint that queries a specific view definition. For example:

```text
GET /direct-web-services/v1/investments/{id}/equity-basic-reference
```

### [2: Specify Investments](#_2-specify-investments)

Pass a single identifier in the path.

```text
GET /direct-web-services/v1/investments/0P00000046/equity-basic-reference
```

If you are not using a Morningstar Performance ID, use `idType` and the lookup filters.

```text
GET /direct-web-services/v1/investments/US5434957743/equity-basic-reference?idType=isin&baseCurrency=USD
```

### [3: Apply Additional Filters (Optional)](#_3-apply-additional-filters-optional)

Set values for any additional filters required for the view being queried.

```text
GET /direct-web-services/v1/investments/0P00000046/quantitative-equity-rating-analysis?quantitativeSmartTextType=MOAT
```

### [4: Set a Date Range (Optional)](#_4-set-a-date-range-optional)

To retrieve time series data, set a `startDate` and an `endDate`.

```text
GET /direct-web-services/v1/investments/0P00000046/equity-consensus-recommendations?startDate=2025-06-01&endDate=2026-06-01
```

## [Send the Request](#send-the-request)

### [Example: Most Recent Data](#example-most-recent-data)

```text
curl --request GET \
  --url "https://www.us-api.morningstar.com/direct-web-services/v1/investments/0P00000056/equity-basic-details?addressType=1&languageId=CHI" \
  --header "Authorization: Bearer {access_token}"
```

### [Example: Time Series Data](#example-time-series-data)

```text
curl --request GET \
  --url "https://www.us-api.morningstar.com/direct-web-services/v1/investments/0P00000056/equity-basic-details?addressType=1&languageId=CHI&startDate=2024-01-01&endDate=2026-01-01" \
  --header "Authorization: Bearer {access_token}"
```

## [Work With Results](#work-with-results)