# Time series predictions for deployments (Serverless)

> Time series predictions for deployments (Serverless) - Make time series predictions for a deployed
> model using serverless prediction environments.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-05-06T18:17:09.623293+00:00` (UTC).

## Primary page

- [Time series predictions for deployments (Serverless)](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html): Full documentation for this topic (HTML).

## Sections on this page

- [Request parameters](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#request-parameters): In-page section heading.
- [Headers](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#headers): In-page section heading.
- [Query arguments (time series models only)](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#query-arguments): In-page section heading.
- [Body](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#body): In-page section heading.
- [Response 200](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#response-200): In-page section heading.
- [Regression prediction example](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#regression-prediction-example): In-page section heading.
- [Binary classification prediction example](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#binary-classification-prediction-example): In-page section heading.
- [Errors List](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/time-pred.html#errors-list): In-page section heading.

## Related documentation

- [Developer documentation](https://docs.datarobot.com/en/docs/api/index.html): Linked from this page.
- [API reference](https://docs.datarobot.com/en/docs/api/reference/index.html): Linked from this page.
- [Prediction API](https://docs.datarobot.com/en/docs/api/reference/predapi/index.html): Linked from this page.
- [Serverless Prediction API reference](https://docs.datarobot.com/en/docs/api/reference/predapi/pred-ref-serverless/index.html): Linked from this page.
- [forecast point](https://docs.datarobot.com/en/docs/reference/glossary/index.html#forecast-point): Linked from this page.
- [Prediction Explanations](https://docs.datarobot.com/en/docs/api/reference/predapi/legacy-predapi/pred-ref/dep-predex.html): Linked from this page.

## Documentation content

Endpoint: `/api/v2/deployments/<deploymentId>/predictions`

Makes time series predictions for a deployed model using serverless prediction environments.

Request Method: `POST`

Request URL: REST API URL, for example: `https://your-company.datarobot.com/api/v2`

## Request parameters

### Headers

| Key | Type | Description | Example(s) |
| --- | --- | --- | --- |
| Authorization | string | Three methods are supported: Bearer authentication(deprecated) Basic authentication: User_email and API token(deprecated) API token | Example for Bearer authentication method: Bearer API_key-12345abcdb-xyz6789(deprecated) Example for User_email and API token method: Basic Auth_basic-12345abcdb-xyz6789(deprecated) Example for API token method: Token API_key-12345abcdb-xyz6789 |

### Query arguments (time series models only)

| Key | Type | Description | Example(s) |
| --- | --- | --- | --- |
| forecastPoint | ISO-8601 string | An ISO 8601 formatted DateTime string, without timezone, representing the forecast point. This parameter cannot be used if predictionsStartDate and predictionsEndDate are passed. | ?forecastPoint=2013-12-20T01:30:00Z |
| relaxKnownInAdvanceFeaturesCheck | bool | true or false. When true, missing values for known-in-advance features are allowed in the forecast window at prediction time. The default value is false. Note that the absence of known-in-advance values can negatively impact prediction quality. | ?relaxKnownInAdvanceFeaturesCheck=true |
| predictionsStartDate | ISO-8601 string | The time in the dataset when bulk predictions begin generating. This parameter must be defined together with predictionsEndDate. The forecastPoint parameter cannot be used if predictionsStartDate and predictionsEndDate are passed. | ?predictionsStartDate=2013-12-20T01:30:00Z&predictionsEndDate=2013-12-20T01:40:00Z |
| predictionsEndDate | ISO-8601 string | The time in the dataset when bulk predictions stop generating. This parameter must be defined together with predictionsStartDate. The forecastPoint parameter cannot be used if predictionsStartDate and predictionsEndDate are passed. | See above. |

It is possible to use standard URI parameters, including `passthroughColumns`, `passthroughColumnsSet`,  and `maxExplanations`.

> [!NOTE] XEMP-based explanations support
> Time series supports XEMP explanations. See [Prediction Explanations](https://docs.datarobot.com/en/docs/api/reference/predapi/legacy-predapi/pred-ref/dep-predex.html) for examples of the `maxExplanations` URI parameter.

### Body

| Data | Type | Example(s) |
| --- | --- | --- |
| Historic and prediction data | JSON | Raw data shown in image below. |

### Response 200

#### Regression prediction example

```
{
  "data": [
    {
      "seriesId": null,
      "forecastPoint": "2013-12-20T00:00:00Z",
      "rowId": 35,
      "timestamp": "2013-12-21T00:00:00.000000Z",
      "predictionValues": [
        {
        "value": 2.3353628422,
        "label": "sales (actual)"
        }
    ],
    "forecastDistance": 1,
    "prediction": 2.3353628422
    }
  ]
}
```

#### Binary classification prediction example

```
{
  "data": [
    {
      "rowId": 147,
      "prediction": "low",
      "predictionThreshold": 0.5,
      "predictionValues": [
        {"label": "low", "value": 0.5158823954},
        {"label": "high", "value": 0.4841176046},
      ],
      "timestamp": "1961-04-01T00:00:00.000000Z",
      "forecastDistance": 2,
      "forecastPoint": "1961-02-01T00:00:00Z",
      "seriesId": null,
    }
  ]
}
```

## Errors List

| HTTP Code | Sample error message | Reason(s) |
| --- | --- | --- |
| 400 BAD REQUEST | {"message": "Based on the forecast point (10/26/08), there are no rows to predict that fall inside of the forecast window (10/27/08 to 11/02/08). Try adjusting the forecast point to an earlier date or appending new future rows to the data."} | No empty rows were provided to predict on. |
| 400 BAD REQUEST | {"message": "No valid output rows"} | No historic information was provided; there's only 1 row to predict on. |
| 400 BAD REQUEST | {"message": "The \"Time\" feature contains the value 'OCT-27', which does not match the original format %m/%d/%y (e.g., '06/24/19'). To upload this data, first correct the format in your prediction dataset and then try the import again. Because some software automatically converts the format for display, it is best to check the actual format using a text editor."} | Prediction row has a different format than the rest of the data. |
| 400 BAD REQUEST | {"message": "The following errors are found:\n • The prediction data must contain historical values spanning more than 35 day(s) into the past. In addition, the target cannot have missing values or missing rows which are used for differencing"} | Provided dataset has fewer than the required 35 rows of historical data. |
| 400 BAD REQUEST | {"message": {"forecastPoint": "Invalid RFC 3339 datetime string: "}} | Provided an empty or non-valid forecastPoint. |
| 404 NOT FOUND | {"message": "Deployment :deploymentId cannot be found for user :userId"} | Deployment was removed or doesn't exist. |
| 422 UNPROCESSABLE ENTITY | {"message": "Predictions on models that are not time series models are not supported on this endpoint. Please use the predict endpoint instead."} | Provided deploymentId that is not for a time series project. |
| 422 UNPROCESSABLE ENTITY | {"message": {"relaxKnownInAdvanceFeaturesCheck": "value can't be converted to Bool"}} | Provided an empty or non-valid value for relaxKnownInAdvanceFeaturesCheck'. |