API reference / KYC / Identity
Revoked-number check (MNRL)
Whether the number is on DoT's Mobile Number Revocation List, with DoT's Financial Fraud Risk Indicator.
POST
/v1/verify/mobile/mnrl- Authentication
- Bearer token
- Scope
kyc:verify
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/mnrl' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mobile": "9876543210"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"mnrl_check": {
"match_found": false
},
"fri_check": {
"match_found": false
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
mnrl_check | object | Whether the number is on the Mobile Number Revocation List kept by the Department of Telecommunications. |
fri_check | object | The Financial Fraud Risk Indicator the Department of Telecommunications has for the number. |
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.