# 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](/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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api2-ekycportal.innov8tif.com/emas-ekyc-portal/centralized-okayface-plus/version-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.