---
title: Face Extraction
slug: us-apis/face-extraction
description: Learn how to utilize an advanced facial recognition and extraction API in this comprehensive document. Find out how to easily detect and extract faces from ID card images for applications like identity verification or facial biometric matching. Discover e
createdAt: 2023-07-03T10:17:24.612Z
---

## Introduction

This API is equipped with facial recognition and extraction capabilities. It can detect and extract faces from ID card images, enabling further analysis or comparison with reference photos, if available. This functionality can be useful for identity verification or facial biometric matching purposes.

## API Details

You need to pass `performFaceExtraction` as True in order to use this feature. 

We have mentioned only this feature in the below Curl. For Curl with complete features, refer the [ID Intelligence](docId:9dWPKYoaeY2mFiYs4oKlD)

### Sample Curl

```curl
curl --location 'https://preproduction.signzy.tech/api/v2/patrons/{patronId}/documentIntelligence' \
--header 'authorization: {signzy-api-authKey}' \
--header 'content-type: application/json' \
--data '{
    "task": "idIntelligence",
    "essentials": {
        "frontUrl": "<front-image-url>",
        "backUrl": "<back-image-url>",
        "country": "<country>",
        "idType": "<id-type> ",
        "performFaceExtraction": true/false,
    }
}'
```

### Response

```json
{
    "essentials": {
        "frontUrl": "", 
        "backUrl": "",  
        "country": "",  
        "idType": "",   
        "performFaceExtraction": true/false
    },
    "id": "60xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "patronId": "60xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task": "idIntelligence",
    
    "result": {
        "faceUrl": "...url of cropped face..."
                }

      
```

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::