---
title: "GET /behavior-model-training/summaries"
method: GET
path: "/behavior-model-training/summaries"
---

# GET /behavior-model-training/summaries

`GET /behavior-model-training/summaries`

Returns a Device Defender's ML Detect Security Profile training model's status.

Requires permission to access the [GetBehaviorModelTrainingSummaries](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Query parameters

- `securityProfileName` string
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- GetBehaviorModelTrainingSummariesResponse
  - `summaries` BehaviorModelTrainingSummary[] — A list of all ML Detect behaviors and their model status for a given Security Profile.
    - `securityProfileName` string — The name of the security profile.
    - `behaviorName` string — The name of the behavior.
    - `trainingDataCollectionStartDate` string, date-time — The date a training model started collecting data.
    - `modelStatus` 'PENDING_BUILD' | 'ACTIVE' | 'EXPIRED' — The status of the behavior model.
    - `datapointsCollectionPercentage` number, double — The percentage of datapoints collected.
    - `lastModelRefreshDate` string, date-time — The date the model was last refreshed.
  - `nextToken` string — A token that can be used to retrieve the next set of results, or <code>null</code> if there are no additional results.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — InternalFailureException
- `483` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)