---
title: "Error Messages"
description: "400 and 403 status messages."
url: "https://developer-beta.morningstar.com/investment-list-api/error-messages"
image: "https://developer-beta.morningstar.com/_og/d/c_Ocean.takumi,title_~RXJyb3IgTWVzc2FnZXMgfCBJbnZlc3RtZW50IExpc3QgQVBJ,description_400+and+403+status+messages.,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDAwMDAifX19,p_Ii9pbnZlc3RtZW50LWxpc3QtYXBpL2Vycm9yLW1lc3NhZ2VzIg,s_2ZYNfhWRjp-J82uC.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 List API

Build the Investment List API into your digital experience for quick investment and earnings summaries.

# Errors

[View Markdown](https://developer-beta.morningstar.com/investment-list-api/error-messages.md)[Download Markdown](https://developer-beta.morningstar.com/investment-list-api/error-messages.md)

This page lists the error messages returned by the Investment List API.

An error response contains a `statusCode`, an `errorCode`, a `message` and a `requestId`. Include the `requestId` if you contact support.

```json
{
  "statusCode": 400,
  "errorCode": "400.investmentList.004",
  "message": "Invalid datapoints companyGrade.profitaityGrade, legalName. Please send the name correctly",
  "requestId": "e08f8bbc-f5f5-4587-a65a-41e7d056a50c"
}
```

Placeholders in the messages below, such as `{0}`, are replaced with the values from your request.

## [400 - Bad Request](#_400-bad-request)

| statusCode | errorCode              | message                                                                          |
| :--------- | :--------------------- | :------------------------------------------------------------------------------- |
| 400        | 400.investmentList.002 | The {0} parameter is required.                                                   |
| 400        | 400.investmentList.003 | The number of {0} exceeds limit. Maximum {0} allowed are {1} per request         |
| 400        | 400.investmentList.004 | Invalid datapoints {0}. Please send the datapoint name correctly                 |
| 400        | 400.investmentList.005 | Missing Values for sort parameter either DataPoint or OrderBy                    |
| 400        | 400.investmentList.006 | Please provide correct values for OrderBy which is 'asc' or 'desc'               |
| 400        | 400.investmentList.007 | Mismatch values of the dataPoint provided in sort. Please verify the dataPoint from the datapoints node in order to sort |
| 400        | 400.investmentList.008 | IdType {0} is not supported for the lookup service setting value {1}             |
| 400        | 400.investmentList.009 | Invalid JSON input. Provide request input in valid JSON.                         |
| 400        | 400.investmentList.010 | Invalid JSON input {0}. Provide request input in valid JSON.                     |
| 400        | 400.investmentList.011 | Provide either datapoints or datasetId, not both.                                |
| 400        | 400.investmentList.012 | Provide either investments or investmentListId, not both.                        |
| 400        | 400.investmentList.013 | Provide either datapoints or datasetId.                                          |
| 400        | 400.investmentList.014 | Provide either investments or investmentListId.                                  |
| 400        | 400.investmentList.015 | sort is not allowed when datasetId is provided.                                  |
| 400        | 400.investmentList.016 | The datasetId provided does not exist.                                           |
| 400        | 400.investmentList.018 | The investmentListId provided does not exist.                                    |

## [403 - Forbidden](#_403-forbidden)

| statusCode | errorCode              | message                                                |
| :--------- | :--------------------- | :----------------------------------------------------- |
| 403        | 403.investmentList.017 | Access to the requested datasetId is forbidden.        |
| 403        | 403.investmentList.019 | Access to the requested investmentListId is forbidden. |