---
title: "Verify Customer OTP"
method: POST
path: "/v3/customer/account/otp/verify"
---

# Verify Customer OTP

`POST /v3/customer/account/otp/verify`

Verify a customer's mobile number via OTP

## Path parameters

- `customer_id` string, required

## Headers

- `developer_key` string, required
- `secret-key` string, required
- `secret-key-timestamp` string, required

## Request body

- object
  - `initiator_id` string, required — The unique cell number with which you are onboarded on Eko's platform. For UAT refer to [Platform Credentials] (https://developers.eko.in/docs/platform-credentials)
  - `user_code` string, required — User code value of the retailer from whom the request is coming
  - `otp` integer — Which you received by calling Create Customer or Resend OTP API or Get Customer Info (For Existing Customer) or Validate Aadhar on customer's number
  - `otp_ref_id` integer, required — Which you received by calling Create Customer or Resend OTP API or Get Customer Info (For Existing Customer) or Validate Aadhar

## Response `200`

200

- union
  - object
    - `response_status_id` integer
    - `data` object
      - `customer_profile` object
        - `total_monthly_limit` string
        - `mobile` string
        - `kyc_id` string
        - `ekyc_enabled` integer
        - `kyc_validity` string
        - `kyc_remark` string
        - `kyc_type` string
        - `balance` string
        - `next_allowed_limit` string
        - `name` string
        - `digital_ekyc` integer
        - `chart` object[]
          - `data_type_id` integer
          - `data` object
            - `unavailable` integer
            - `used` integer
            - `remaining` integer
          - `label` string
        - `email` string
        - `kyc_state` integer
      - `id_proof_type_id` string
      - `is_registered` integer
      - `id_proof` string
      - `otpOptionalSum` string
      - `sender_name` string
      - `otpNotRequiredSum` string
      - `ekyc_enabled` string
      - `otpNotRequiredSumNeft` string
      - `next_allowed_limit` integer
      - `account` string
      - `kyc_state` integer
      - `otpOptionalSumNeft` string
    - `response_type_id` integer
    - `message` string
    - `status` integer
  - object
    - `response_status_id` integer
    - `response_type_id` integer
    - `message` string
    - `status` integer
  - object
    - `response_status_id` integer
    - `data` object
      - `application_id` string
    - `response_type_id` integer
    - `message` string
    - `status` integer

---

[API](https://skmtc.dev/eko/apis/eps-api.md) · [All operations](https://skmtc.dev/eko/apis/eps-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eko/eps-api/revisions/0d0e8e6573b6/schema)