> ## Documentation Index
> Fetch the complete documentation index at: https://ekacare-quickstart-cleanup.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

### ABHA Address

An ABHA Address is a memorable username that allows users to access and manage their health records digitally and share them with various healthcare providers.
It follows the format `sudev@abdm` and is essential identifier for all ABDM transactions.

### ABHA Number

The ABHA Number is a unique 14-digit identifier issued after a thorough **KYC process**.
Multiple ABHA Address can be attached to a ABHA Number.

## Creating an ABHA Number with Aadhaar

ABHA Numbers can be generated by authenticating with Aadhaar. Aadhaar serves as the KYC here.

<Steps>
  <Step title="Enter the Aadhaar Number">
    Use the [Initiate Aadhaar Registration](/api-reference/user-app/abdm-connect/enrollment/aadhaar/initiate-registration) endpoint to start the Aadhaar registration process.
  </Step>

  <Step title="Verify Aadhaar OTP">
    Use the [Verify Aadhaar OTP](/api-reference/user-app/abdm-connect/enrollment/aadhaar/verify-otp) endpoint to verify the OTP generated for Aadhaar registration.
  </Step>

  <Step title="Verify Mobile Number (Optional)">
    If the mobile number provided in the second step differs from the one linked to Aadhaar, use the [Verify New Mobile Number](/api-reference/user-app/abdm-connect/enrollment/aadhaar/mobile-verify) endpoint to verify the new mobile number.
  </Step>

  <Step title="Create ABHA Address">
    Use the [Create ABHA Address](/api-reference/user-app/abdm-connect/enrollment/aadhaar/create-abha) endpoint to generate a new ABHA address.
  </Step>
</Steps>

## Creating ABHA Address using Mobile

<Steps>
  <Step title="Enter Mobile Number">
    Use the [Initiate Mobile Registration](/api-reference/user-app/abdm-connect/enrollment/mobile/init) endpoint to start the registration process for a mobile number.
  </Step>

  <Step title="Verify Mobile OTP">
    Use the [Verify Mobile OTP](/api-reference/user-app/abdm-connect/enrollment/mobile/verify) endpoint to verify the OTP sent to the mobile number.

    The response from the verification will include the user's existing ABHA Address associated with the mobile number. In the next step, the user can either create a new ABHA Address or log in to the existing ABHA Address.
  </Step>

  <Step title="Create ABHA Address">
    * To create a new ABHA Address use [Create ABHA Address](/api-reference/user-app/abdm-connect/enrollment/mobile/create).
  </Step>
</Steps>

## Logging into ABHA Address

<Steps>
  <Step title="Initiate Login">
    Use the [Login Initiation](/api-reference/user-app/abdm-connect/login/init) endpoint to start the login process by entering the mobile number.
  </Step>

  <Step title="Verify Login OTP">
    Use the [Verify Login OTP](/api-reference/user-app/abdm-connect/login/verify) endpoint to verify the OTP sent to the registered mobile number.

    After successful verification, the response will include the user's existing ABHA Address associated with the mobile number.

    If the `method` in the **Login init API** is set to **"abha\_address"**, then this API itself will complete the login process, and no further API call is required.
  </Step>

  <Step title="Login to ABHA Address">
    Use the [Login](/api-reference/user-app/abdm-connect/login/login) endpoint to authenticate and access the ABHA Address.
  </Step>
</Steps>

### Skip State Enum

The **Skip State Enum** in the API response determines the next screen the user should see:

* **abha\_end** – This state indicates that the ABHA registration or login process is complete, and no further action is needed.
* **confirm\_mobile\_otp** – This occurs when a user verifies their Aadhaar OTP but enters a mobile number that is not linked to their Aadhaar. In this case, the user should be taken to the mobile verification page.
* **abha\_select** – If the state is `abha_select`, the user should be taken to the login page, where they have multiple ABHA addresses. They can choose one to proceed with the login.
* **abha\_create** – This indicates that no ABHA address has been created yet, so the user should be directed to the ABHA creation page.