# FaceMatch
<a name="API_FaceMatch"></a>

Provides face metadata. In addition, it also provides the confidence in the match of this face with the input face.

## Contents
<a name="API_FaceMatch_Contents"></a>

 ** Face **   <a name="rekognition-Type-FaceMatch-Face"></a>
Describes the face properties such as the bounding box, face ID, image ID of the source image, and external image ID that you assigned.  
Type: [Face](API_Face.md) object  
Required: No

 ** Similarity **   <a name="rekognition-Type-FaceMatch-Similarity"></a>
Confidence in the match of this face with the input face.  
Type: Float  
Valid Range: Minimum value of 0. Maximum value of 100.  
Required: No

## See Also
<a name="API_FaceMatch_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/rekognition-2016-06-27/FaceMatch) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/rekognition-2016-06-27/FaceMatch) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/rekognition-2016-06-27/FaceMatch)