# Face Match

## face\_match

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/vision/face_match`

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td> selfie</td><td>String </td><td>Yes </td><td>Selfie Image Url or Base64 String</td></tr><tr><td>id_card</td><td>String</td><td>Yes</td><td>Document Image Url or Base64 String</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "selfie": "Image URL/Base64 String",
    "id_card": "Image URL/Base64 String"
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "ffebbc0a-278e-43a9-9b86-0ed74f3a8a3e",
    "status": "completed",
    "result": {
        "match": "yes",
        "match_score": 97,
        "confidence": 98,
        "to_be_reviewed": "no"
    },
    "requested_at": "2023-01-12T08:53:04.074Z",
    "completed_at": "2024-08-28T07:53:04.525Z"
}       
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Selfie image should not be empty",
        "field": "selfie",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "76d049e8-e9eb-4095-8926-74235763cf8a",
    "status": "failed",
    "error": {
        "message": "Verification Failed.",
        "code": "ERROR"
    },
    "requested_at": "2024-03-18T05:12:26.884Z",
    "completed_at": "2024-03-18T05:12:27.305Z"
}
```

{% endtab %}
{% endtabs %}