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

FieldTypeRequiredDescription
mobilestringYes10-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

FieldTypeDescription
customer_namestringSubscriber name on the telecom record.
alternate_numberstringAlternate number on the record, when recorded.
is_validstringWhether the number is a valid, working subscription.
subscriber_statusstringStatus of the subscription.
connection_typestringWhether the connection is prepaid or postpaid.
current_service_providerstringOperator the number is with today.
original_service_providerstringOperator the number was first issued by.
network_regionstringTelecom circle of the number.
is_portedstringWhether 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.