API reference / Business / KYB
Udyam by OTP: send
Sends an OTP to the enterprise's registered mobile and returns the request_id.
POST
/v1/business/udyam/otp- Authentication
- Bearer token
- Scope
kyc:verify
Before you integrate
- This is step 1 of 2. The OTP goes to the enterprise's registered mobile; call /v1/business/udyam/otp/verify with this request_id and the OTP to finish.
- The request_id inside result is the OTP reference. It is separate from the request_id at the top of the reply, which identifies your API call.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
udyam_number | string | Yes | Udyam registration number in the form UDYAM-XX-00-0000000. Case and spaces are ignored; keep the hyphens. |
mobile | string | Yes | Mobile number registered on the Udyam record. 10-digit Indian mobile number starting 6 to 9; a leading +91, 91 or 0 and spaces are ignored. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/business/udyam/otp' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"udyam_number": "UDYAM-MH-19-0012345",
"mobile": "9876543210"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"request_id": "udyam_otp_abc123"
}
}Response fields
| Field | Type | Description |
|---|---|---|
request_id | string | Reference for this OTP. Send it, with the OTP, to /v1/business/udyam/otp/verify. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.