> For the complete documentation index, see [llms.txt](https://api2-ekycapis.innov8tif.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api2-ekycapis.innov8tif.com/okayface-search/okayface-search-all/search-face-api/versions.md).

# Versions

{% hint style="info" %}
Recommended/Latest version is always placed at the top of the page. (v2 for OkayFace) 
{% endhint %}

## Search Face - V1

## Search Face API - V1

<mark style="color:green;">`POST`</mark> `http://okayfacesearchdemo.innov8tif.com/v1/facesearch/search-faces`

#### Headers

| Name                                            | Type   | Description                                                                                                                                                                                                           |
| ----------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | <p>The access token is valid for 10 minutes and retrieve this from Get Token API</p><p><a data-footnote-ref href="#user-content-fn-1"><em><mark style="color:blue;">bearer\_token {{accessToken}}</mark></em></a></p> |

#### Request Body

| Name                                        | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| api\_key <mark style="color:red;">\*</mark> | string | To be assigned by Innov8tif                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data<mark style="color:red;">\*</mark>      | string | <p>Please refer to "How to encrypt and decrypt data page"</p><p>Encrypt the following parametr </p><p></p><p><code>1)  </code><strong><code>person\_id (string)</code></strong><code> (ID Number/unique of the person)</code> </p><p><code>2) </code><strong><code>person\_name (string)</code></strong><code> (name of the person)</code></p><p><code>3) </code><strong><code>image (string)</code></strong><code> (Base64 string of the selfie image)</code> </p><p></p> |

{% tabs %}
{% tab title="200 Response from search face API" %}
{% code overflow="wrap" %}

```json

Encrypted Form
{
    "success": true,
    "data": "4oCmb8Y4Uk7OKAyKpHVynZLiDSB4ULjo97zAiX/Wb2koDsvyaMIvI2hF+0Ml+U6y/XT8IOGERGAYuQvRLwe1l5lRiDGEsn0FBV5OyMXqftG78W7LA0GscS9iqCkfhVhc"
}

Decrypted Form
{
   "success":true,
   “data”: 
   {
       {"status_code":1,"status_message":"Successfully fetched the result","FaceNum":448,"FaceModelVersion":"3.0","RequestId":"74e971ad-6a59-4564-9e9a-b0688069380e","face":[{"account_source":"Innov8tif","image":"data:image\/jpeg;base64,","match_result":100,"person_id":"000000-07-01","blacklist":"Y"}],"status":"Found And Match"}
    }
}




```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

#### Postman Collection

[^1]: