---
title: "Generate OKYC OTP"
method: POST
path: "/verify/okyc_generate_otp"
tags: ["OKYC"]
---

# Generate OKYC OTP

`POST /verify/okyc_generate_otp`

Generates an OTP for Aadhaar offline KYC. Requires X-Client-ID and X-API-KEY headers.

## Request body

- OKYCGenerateOtpRequest — Generate OTP for Aadhaar offline KYC. Provide either uid or aadhaar_number.
  - `aadhaar_number` string, required — 12 digit Aadhaar number.
  - `user_id` string, nullable — Optional customer-side user identifier for tracking.

## Response `200`

OTP generated successfully.

- OKYCGenerateOtpResponse
  - `message` string, required — OTP delivery message.
  - `sessionId` string, required — Session ID returned by OTP generation and required for OTP verification.
  - `sessionActive` boolean, required — Whether the OTP session is active.

## Other responses

- `400` — Bad request - missing or invalid input.
- `401` — Unauthorized - X-Client-ID or X-API-KEY missing or invalid.
- `500` — Internal server error.
- `502` — Bad gateway - verification service unavailable.
- `504` — Gateway timeout - verification service did not respond.

---

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