> 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/create-journeyid.md).

# Create JourneyID

## **Overview**

The user is required to enter the username and password that will be provided by Innov8tif Solutions upon request for the API testing. By obtaining the Journey ID, the user will have the access to all of the APIs that are requested by Innov8tif Solutions so that the user can call each of the APIs.

**Steps:**

1. Obtain the username and password from the Innov8tif side.
2. Check out the [API Method](#api-method) and follow the [Example](#input-example-for-create-journeyid) by calling the API.
3. After step 2, the user should obtain the JourneyId. The JourneyId should be used for the rest of **one** eKYC flow.
4. After completing the Create JourneyID API, go to the next [page](/experimental-space/emas-ekyc-portal/centralized-okayid.md).

## API Method

## To get the JourneyID for the user to assign to the API components

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

#### Request Body

| Name                                       | Type   | Description                 |
| ------------------------------------------ | ------ | --------------------------- |
| username<mark style="color:red;">\*</mark> | string | To be assigned by Innov8tif |
| password<mark style="color:red;">\*</mark> | string | To be assigned by Innov8tif |

{% tabs %}
{% tab title="200: OK Successfully Retrieved JourneyID from eKYC" %}
{% code title="Response Code Block" %}

```
{
    "status": "success",
    "message": "api.success",
    "journeyId": "7851b4e3-df09-4ab6-8091-xxxxxxxxxxx"
}
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request Failed to request for JourneyID from eKYC" %}

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

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

{% hint style="danger" %}
JourneyID along with the data submitted will be purged after 14 days
{% endhint %}

{% hint style="warning" %}
Only backend to backend call is supported.
{% endhint %}

### Input Example for Create JourneyId

{% code title="Request Code Block " %}

```
{
    "username":"userabc123",
    "password":"%$aBc1293"
}
```

{% endcode %}

{% hint style="info" %}
The credentials are provided by Innov8tif Solutions.
{% endhint %}

#### Postman Collection

{% file src="/files/OzYU8tOxHl0lym5ztLGD" %}