Media Server 25.3
Media Server Help

# 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 OpenText recommends you remove these images with the action `RemoveFaceImages`.

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.3

Topic Title: List the Faces in a Database