---
title: "GET /largepersongroups/{largePersonGroupId}/training"
method: GET
path: "/largepersongroups/{largePersonGroupId}/training"
---

# GET /largepersongroups/{largePersonGroupId}/training

`GET /largepersongroups/{largePersonGroupId}/training`

Retrieve the training status of a large person group (completed or ongoing).

## Path parameters

- `largePersonGroupId` string, required

## Response `200`

A successful call returns the large person group's training status.

- TrainingStatus — Training status object.
  - `status` 'nonstarted' | 'running' | 'succeeded' | 'failed', required — Training status: notstarted, running, succeeded, failed. If the training process is waiting to perform, the status is notstarted. If the training is ongoing, the status is running. Status succeed means this person group or large person group is ready for Face - Identify, or this large face list is ready for Face - Find Similar. Status failed is often caused by no person or no persisted face exist in the person group or large person group, or no persisted face exist in the large face list.
  - `createdDateTime` string, date-time, required — A combined UTC date and time string that describes the created time of the person group, large person group or large face list.
  - `lastActionDateTime` string, date-time — A combined UTC date and time string that describes the last modify time of the person group, large person group or large face list, could be null value when the group is not successfully trained.
  - `lastSuccessfulTrainingDateTime` string, date-time — A combined UTC date and time string that describes the last successful training time of the person group, large person group or large face list.
  - `message` string — Show failure message when training failed (omitted when training succeed).

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/azure/apis/face-client.md) · [All operations](https://skmtc.net/azure/apis/face-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/face-client/versions/106051bfd7b7/schema)