# ListObjectClassAnnotations

Lists the annotations that you have added to your training images. An annotation identifies a region of a training image that contains an object, and the class that the object belongs to. Media Server can then use that region of the image to train the recognizer.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`recognizer` | The name of the recognizer to list annotations for. | Yes
`imagelabels` | A comma-separated list of image labels to list the annotations for. Set this parameter to list annotations only for selected images. | No
`identifiers` | A comma-separated list of object class identifiers to list the annotations for. Set this parameter to list annotations only for selected object classes. | No

## Example

The following example lists all annotations for the `vehicles` recognizer.

    /action=ListObjectClassAnnotations&recognizer=vehicles

This action can return a significant amount of data, so you might use the `imagelabels` parameter to return the annotations for a single image:

    /action=ListObjectClassAnnotations&recognizer=vehicles&imagelabels=image1

## Response

The following XML is an example response that shows the annotations for a single image. There are two annotations. The first identifies a region to use to train the `car` object class and the second identifies a region to use to train the `van` object class. The `left`, `top`, `width`, and `height` values for the region are always returned in pixels, even if the values were set using percentages.

    <autnresponse>
      <action>LISTOBJECTCLASSANNOTATIONS</action>
      <response>SUCCESS</response>
      <responsedata>
        <image>
          <imagelabel>image1</imagelabel>
          <annotations>
            <annotation>
              <annotationlabel>annotation1</annotationlabel>
              <identifier>car</identifier>
              <region>
                <left>0</left>
                <top>50</top>
                <width>50</width>
                <height>50</height>
              </region>
            </annotation>
            <annotation>
              <annotationlabel>annotation2</annotationlabel>
              <identifier>van</identifier>
              <region>
                <left>50</left>
                <top>0</top>
                <width>50</width>
                <height>50</height>
              </region>
            </annotation>
          </annotations>
        </image>
      </responsedata>
    </autnresponse>

_FT_HTML5_bannerTitle.htm