API reference / KYC / Identity
Silent mobile check
Checks a number against the telco record without sending an OTP.
POST
/v1/verify/mobile/silent- Authentication
- Bearer token
- Scope
kyc:verify
Before you integrate
- No OTP is sent and the person does not have to do anything, so this does not prove they hold the number.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
mobile | string | Yes | 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/verify/mobile/silent' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mobile": "9876543210"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"customer_name": "ASHA RAO",
"alternate_number": "",
"is_valid": "true",
"subscriber_status": "ACTIVE",
"connection_type": "PREPAID",
"current_service_provider": "Example Telecom",
"original_service_provider": "Example Telecom",
"network_region": "Maharashtra",
"is_ported": "false"
}
}Response fields
| Field | Type | Description |
|---|---|---|
customer_name | string | Subscriber name on the telecom record. |
alternate_number | string | Alternate number on the record, when recorded. |
is_valid | string | Whether the number is a valid, working subscription. |
subscriber_status | string | Status of the subscription. |
connection_type | string | Whether the connection is prepaid or postpaid. |
current_service_provider | string | Operator the number is with today. |
original_service_provider | string | Operator the number was first issued by. |
network_region | string | Telecom circle of the number. |
is_ported | string | Whether the number has been moved to another operator. |
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.