---
title: "GET /snapshots"
method: GET
path: "/snapshots"
---

# GET /snapshots

`GET /snapshots`

List all accessible snapshots with related information, including snapshots that were taken by the user, or snapshots to be applied to the user (subscription id was included in the applyScope in Snapshot - Take).

## Query parameters

- `type` 'FaceList' | 'LargeFaceList' | 'LargePersonGroup' | 'PersonGroup'
- `applyScope` string[]

## Response `200`

A successful call returns an array of snapshots with snapshot information.

- Snapshot[] — An array of snapshots.
  - `id` string, uuid, required — Snapshot id.
  - `account` string, required — Azure Cognitive Service Face account id of the subscriber who created the snapshot by Snapshot - Take.
  - `type` 'FaceList' | 'LargeFaceList' | 'LargePersonGroup' | 'PersonGroup', required — Type of the source object in the snapshot, specified by the subscriber who created the snapshot when calling Snapshot - Take. Currently FaceList, PersonGroup, LargeFaceList and LargePersonGroup are supported.
  - `applyScope` string[], required — Array of the target Face subscription ids for the snapshot, specified by the user who created the snapshot when calling Snapshot - Take. For each snapshot, only subscriptions included in the applyScope of Snapshot - Take can apply it.
  - `userData` string — User specified data about the snapshot for any purpose. Length should not exceed 16KB.
  - `createdTime` string, date-time, required — A combined UTC date and time string that describes the created time of the snapshot. E.g. 2018-12-25T11:41:02.2331413Z.
  - `lastUpdateTime` string, date-time, required — A combined UTC date and time string that describes the last time when the snapshot was created or updated by Snapshot - Update. E.g. 2018-12-25T11:51:27.8705696Z.

## Other responses

- `default` — Error response.

---

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