---
title: "Troubleshooting"
description: "Troubleshooting guide for Investment Details API."
url: "https://developer-beta.morningstar.com/investment-details-api/troubleshooting"
image: "https://developer-beta.morningstar.com/_og/d/c_Ocean.takumi,title_~VHJvdWJsZXNob290aW5nIHwgSW52ZXN0bWVudCBEZXRhaWxzIEFQSQ,description_Troubleshooting+guide+for+Investment+Details+API.,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDAwMDAifX19,p_Ii9pbnZlc3RtZW50LWRldGFpbHMtYXBpL3Ryb3VibGVzaG9vdGluZyI,s_T9Z9uLtEpWpYMs-M.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.

# Troubleshooting

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

Use this page to diagnose a failed request or results that don't contain what you expected. Each issue lists the likely causes and how to fix them. For the meaning of a specific error code, see [Error Messages](https://developer-beta.morningstar.com/investment-details-api/error-messages).

## [Before You Start](#before-you-start)

Most problems can be traced to one of the following. Check them first.

-   The `Authorization` header contains `Bearer {token}`, with a token less than 60 minutes old.
-   The body is valid JSON, with `investments` and `views`.
-   There are no more than 250 investments and 3 views, and views that must be submitted alone are alone.
-   Each `idType` matches its `id`, and an entry with no `idType` holds a Morningstar Performance ID.
-   Dates are in `yyyy-MM-dd` format, the range is no more than 60 months, and the view returns time series data.
-   Your package's guide has been checked for extra inputs. See [Package-Specific Guides](https://developer-beta.morningstar.com/investment-details-api/package-specific-guides).

## [Reading an Error Response](#reading-an-error-response)

A failed request returns a `statusCode`, an `errorCode`, a `message` and a `requestId`. The `message` describes the problem.

```json
{
  "statusCode": 400,
  "errorCode": "400.investmentDetailsAsync.010",
  "message": "Invalid date format. Dates must be formatted as YYYY-MM-DD.",
  "requestId": "9d4a2e6f-1b8c-4d3a-b7e5-2c0f9a1d6b84"
}
```

Use the `errorCode` to look up the issue on the [Error Messages](https://developer-beta.morningstar.com/investment-details-api/error-messages) page. Keep the `requestId` in case you need to contact support.

## [Authentication and Access](#authentication-and-access)

401 Unauthorized

The token is missing, invalid or expired.

-   Check that the `Authorization` header is present and uses the format `Bearer {token}`.
-   Tokens expire after 60 minutes. Request a new token from `POST /token/oauth`, then retry the request.
-   In long-running jobs, refresh the token before it expires, and retry any request that returns `401` after refreshing.

See [Authentication](https://developer-beta.morningstar.com/api-authentication).

---

403 Forbidden

The request was authenticated but access was refused. Confirm that your account is licensed for the data you are requesting. Your Morningstar account manager can confirm what your agreement includes.

---

500 Internal Server Error

An error occurred on the server. Check that the request body is valid JSON, then retry the request. If the error persists, contact Morningstar support with the `requestId` and the time of the request.

---