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

# GET /facelists

`GET /facelists`

List face lists’ faceListId, name, userData and recognitionModel. <br /> 
To get face information inside faceList use [FaceList - Get](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524c)

## Query parameters

- `returnRecognitionModel` boolean

## Response `200`

A successful call returns an array of faceList.

- FaceList[] — An array of face list results, with fields of faceListId, name and userData
  - `name` string — User defined name, maximum length is 128.
  - `userData` string — User specified data. Length should not exceed 16KB.

## Other responses

- `default` — Error response.

## Changes

- **2019-03-25** `37a7900a44ee` — 1 info
  - added the new optional `query` request parameter `returnRecognitionModel`
- **2017-12-28** `e67414f9aeba` — 1 warning
  - deleted the `query` request parameter `returnRecognitionModel`

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-face/changes/facelists/get.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-face.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cognitiveservices-face/revisions/37a7900a44ee/schema)