---
title: "Detect change point for the entire series"
method: POST
path: "/timeseries/changepoint/detect"
---

# Detect change point for the entire series

`POST /timeseries/changepoint/detect`

Evaluate the change point score of every series point.

## Request body

- UnivariateUnivariateChangePointDetectionOptions — Request of change point detection.
  - `series` UnivariateTimeSeriesPoint[], required — Time series data points. Points should be sorted by time stamp in ascending order to match the change point detection result.
    - `timestamp` string, date-time — Argument that indicates the time stamp of a data point (ISO8601 format).
    - `value` number, float, required — Measurement of that point.
  - `granularity` 'yearly' | 'monthly' | 'weekly' | 'daily' | 'hourly' | 'minutely' | 'secondly' | 'microsecond' | 'none', required
  - `customInterval` integer — A custom interval is used to set a nonstandard time interval. For example, if the series is 5 minutes, the request can be set as {"granularity":"minutely", "customInterval":5}.
  - `period` integer — Argument that indicates the periodic value of a time series. If the value is null or not present, the API will determine the period automatically.
  - `stableTrendWindow` integer — Argument that indicates an advanced model parameter. A default stableTrendWindow value will be used in detection.
  - `threshold` number, float — Argument that indicates an advanced model parameter between 0.0 and 1.0. The lower the value is, the larger the trend error is, which means less change point will be accepted.

## Response `200`

The request has succeeded.

- UnivariateUnivariateChangePointDetectionResult — Response of change point detection.
  - `period` integer — Frequency extracted from the series. Zero means no recurrent pattern has been found.
  - `isChangePoint` boolean[] — Change point properties for each input point. True means an anomaly (either negative or positive) has been detected. The index of the array is consistent with the input series.
  - `confidenceScores` number[] — Change point confidence of each point.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-anomalydetector.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-anomalydetector/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-anomalydetector/versions/3d72cecb974e/schema)