> For the complete documentation index, see [llms.txt](https://api2-ekycportal.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-ekycportal.innov8tif.com/experimental-space/emas-ekyc-portal/centralized-okayface-plus/version-1.md).

# Version 1

### Centralized OkayFace Plus Version 1

<mark style="color:green;">`POST`</mark> `https://ekycportaldemo.innov8tif.com/api/ekyc/okayface-plus/v1`

#### Headers

| Key          | Value               |
| ------------ | ------------------- |
| Content-Type | multipart/form-data |

#### &#x20;Request Body

| Field                                            | Type   | Description                                                                 |
| ------------------------------------------------ | ------ | --------------------------------------------------------------------------- |
| journeyId<mark style="color:red;">\*</mark>      | string | Retrieve from 'Create JourneyID' API. Mandatory field.                      |
| imageIdCard <mark style="color:red;">\*</mark>   | object | Multipart file - face image from ID card. Mandatory field.                  |
| imageBest <mark style="color:red;">\*</mark>     | object | Multipart file - Selfie Image. Mandatory field.                             |
| <mark style="color:red;">mobileSdkData \*</mark> | object | Multipart File - bundle data from OkayCam Plus mobile SDK. Mandatory field. |

#### Response Body

<table><thead><tr><th width="246">Field</th><th>Description</th></tr></thead><tbody><tr><td>status</td><td><p>Indicate API status. Values can be </p><ol><li>success</li><li>error.</li></ol></td></tr><tr><td>messageCode</td><td><p>Show when API calls is success.</p><ol><li>api.success</li></ol><p></p></td></tr><tr><td>imageBestLiveness</td><td><p>Show <em><mark style="color:orange;">face</mark></em> liveness probability from 0 (attack) to 1 (live).</p><p></p></td></tr><tr><td><mark style="color:red;">imageBestCaptureLiveness</mark></td><td><p>Show <em><mark style="color:orange;">capture</mark></em> liveness probability from 0 (attack) to 1 (live).</p><p></p></td></tr><tr><td>result_idcard</td><td> Show 1:1 face verification result </td></tr></tbody></table>

{% tabs %}
{% tab title="200 Successfully response to the user" %}
{% code title="Response Code Block" %}

```
{
    "status": "success",
    "messageCode": "api.success",
    "imageBestLiveness": {
        "probability": 0.92135316
    },
    "imageBestCaptureLiveness": {
        "probability": 1.0,
        "score": 0.1745683
    },
    "result_idcard": {
        "confidence": 100.0
    }
}

```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request Failed to response to the user " %}

```javascript
{
    status: "error"
}
```

{% endtab %}

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

```javascript
{
    status: "Internal Server Error"
}
```

{% endtab %}
{% endtabs %}

### Input Example (OkayFace Plus Version 1)

<figure><img src="/files/MT1qb7Zgp9VWAKdZvqZD" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Kindly refer to the page below for the interpretation of the result.
{% endhint %}

{% content-ref url="/pages/wVJuvtoEUh6goiUcbYI7" %}
[Interpretation of Result and Recommended Threshold - Face Plus](/experimental-space/emas-ekyc-portal/centralized-okayface-plus/interpretation-of-result-and-recommended-threshold-face-plus.md)
{% endcontent-ref %}

#### Postman Collection

{% hint style="info" %}
Get the Postman Collection\
<https://api2-ekycportal.innov8tif.com/emas-ekyc-portal/postman-collection>
{% endhint %}