Face API

Face verification

Check the likelihood that two faces belong to the same person. The API will return a confidence score about how likely it is that the two faces belong to one person.
See it in action

Verification result: The two faces belong to the same person. Confidence is 0.7349.

Want to build this?

Face detection

Detect one or more human faces in an image and get back face rectangles for where in the image the faces are, along with face attributes that contain machine learning-based predictions of facial features. The face attribute features available are: Age, Emotion, Gender, Pose, Smile and Facial Hair, along with 27 landmarks for each face in the image.

See it in action

Gender female
Age 23.4
Glasses ReadingGlasses
Smile 0.897
Anger 0.066
Contempt 0.001
Disgust 0.024
Fear 0.002
Happiness 0.897
Neurtral 0.002
Sadness 0.001
Surprise 0.007
Detection result:
[ { "FaceId": "8e83c5ac-94c2-42bf-a18f-a3396b62bd57", "FaceRectangle": { "Top": 74, "Left": 274, "Width": 138, "Height": 138 }, "FaceAttributes": { "Smile": 0.897, "HeadPose": { "Pitch": 0.0, "Roll": -16.6, "Yaw": 9.8 }, "Gender": "female", "Age": 23.4, "FacialHair": { "Moustache": 0.0, "Beard": 0.0, "Sideburns": 0.0 }, "Glasses": "ReadingGlasses", "Emotion": { "Anger": 0.066, "Contempt": 0.001, "Disgust": 0.024, "Fear": 0.002, "Happiness": 0.897, "Neutral": 0.002, "Sadness": 0.001, "Surprise": 0.007 } }, "FaceLandmarks": null } ]

Want to build this?

Face identification

Search and identify faces. Tag people and groups with user-provided data and then search those for a match with previously unseen faces.

Similar face search

Easily find similar-looking faces. Given a collection of faces and a new face as a query, this API will return a collection of similar faces.

Face grouping

Organise many unidentified faces together into groups, based on their visual similarity.


"Thousands of partners sign in to our platform every hour. The response time from the Face API is incredible, enabling us to verify our drivers without slowing them down."

Dima Kovalev: Product Manager

Have a look at the other Cognitive Services APIs

Face API

Detect, analyse, organise and tag faces in photos

Content Moderator

Automated image, text and video moderation


Personalise user experiences with emotion recognition

Computer Vision API

Distil actionable information from images

Language Understanding Intelligent Service PREVIEW

Teach your apps to understand commands from your users

Bing Spell Check API

Detecting and correcting spelling mistakes in your app

Web Language Model API PREVIEW

Use the power of predictive language models trained on web-scale data

Text Analytics API PREVIEW

Easily evaluate sentiment and topics to understand what users want

Translator Text API

Easily conduct automatic text translation with a simple REST API call


Convert speech to text and back again to understand user intent

Custom Speech Service PREVIEW

Overcome speech recognition barriers like speaking style, background noise and vocabulary

Bing Spell Check API

Detecting and correcting spelling mistakes in your app

Speaker Recognition API PREVIEW

Use speech to identify and authenticate individual speakers

Translator Speech API

Easily conduct real-time speech translation with a simple REST API call

Recommendations API PREVIEW

Predict and recommend items that your customers want

Academic Knowledge API PREVIEW

Tap into the wealth of academic content in the Microsoft Academic Graph

Ready to supercharge your app?