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


---

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