# List the Faces in a Database

To list the faces that you have added to a database, and check whether training was successful, use the following procedure.

To list the faces in a database

1. (Optional) First list the databases that have been created to store faces. Use the action `ListFaceDatabases`:

       http://localhost:14000/action=ListFaceDatabases

   Media Server returns a list of databases that you have created to store faces.

2. List the faces that exist in one of the databases. Use the action `ListFaces`, for example:

       http://localhost:14000/action=ListFaces&database=faces
                                              &metadata=true
                                              &imagestatus=true

   Media Server returns a list of faces in the specified database, and the number of training images associated with each face.

   If you set the action parameter `metadata` to `true`, Media Server returns the metadata you have added to a face.

   If you set the action parameter `imagestatus` to `true`, Media Server returns the status of each training image associated with each face.

   - The `status` element indicates the status of training:

     - `trained` indicates that training was successful.
     - `untrained` indicates that training has not been attempted. Run training for the face using the action `BuildFace`, or run training for all faces that have incomplete training using the action `BuildAllFaces`.
     - `failed` indicates that Media Server could not use the image for training. For example, if Media Server does not detect a face in an image, it cannot be used as a training image. Remove the failed image using the action `RemoveFaceImages`.
   - The `hasimagedata` element indicates whether the training image is stored in the database. If the value of this element is `false`, the image has been removed from the database by the action `NullFaceImageData`. Images that have been removed and have a status of `untrained` cannot be trained, so Micro Focus recommends you remove these images with the action `RemoveFaceImages`.

_FT_HTML5_bannerTitle.htm