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

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/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

FieldTypeDescription
mnrl_checkobjectWhether the number is on the Mobile Number Revocation List kept by the Department of Telecommunications.
fri_checkobjectThe 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.