MNRL Check — Mobile Revocation List Lookup
Check if a mobile number has been disconnected or revoked by the telecom operator. Essential fraud check for financial onboarding.
curl -X GET "https://production.deepvue.tech/v1/verification/mnrl/verify?mobile_number=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://production.deepvue.tech/v1/verification/mnrl/verify?mobile_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/mnrl/verify?mobile_number=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://production.deepvue.tech/v1/verification/mnrl/verify?mobile_number=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/mnrl/verify?mobile_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1742331301024,
"transaction_id": "e1537caeafa147fa8965f40842e70192",
"sub_code": "LATEST_MNRL_RECORD_FOUND",
"message": "MNRL record found",
"data": {
"mnrl_record_found": true,
"phone_number": "6000014143",
"latest_revocation_status": true,
"first_revocation_month": "September",
"first_revocation_year": 2024,
"latest_revocation_month": "January",
"latest_revocation_year": 2025
}
}
{
"code": 200,
"timestamp": 1742331301024,
"transaction_id": "e1537caeafa147fa8965f40842e70192",
"sub_code": "MNRL_RECORD_FOUND",
"message": "MNRL record found",
"data": {
"mnrl_record_found": true,
"phone_number": "6000014143",
"latest_revocation_status": false,
"first_revocation_month": "September",
"first_revocation_year": 2024,
"latest_revocation_month": "September",
"latest_revocation_year": 2024
}
}
{
"code": 200,
"timestamp": 1742331301024,
"transaction_id": "e1537caeafa147fa8965f40842e70192",
"sub_code": "NO_MNRL_RECORD_FOUND",
"message": "MNRL record not found",
"data": {
"mnrl_record_found": false,
"phone_number": "9999999999",
"latest_revocation_status": false,
"first_revocation_month": null,
"first_revocation_year": null,
"latest_revocation_month": null,
"latest_revocation_year": null
}
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 500,
"timestamp": null,
"transaction_id": "string",
"sub_code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}
{
"code": null,
"timestamp": null,
"transaction_id": "string",
"message": "Source Unavailable"
}
/v1/verification/mnrl/verify
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
Overview
The MNRL Check API verifies mobile numbers against the MNRL (Mobile Number Revocation List) database. This service determines whether a given phone number has been revoked and tracks the history of any revocations.
The API accepts a mobile number as input and queries the MNRL database to determine whether a record exists for the provided number, the current revocation status, and the timeline of revocations (first occurrence and most recent).
Response outcomes
The API returns three possible outcomes:
- Latest MNRL record found — A record exists with a current active revocation status.
- MNRL record found — A record exists but is not currently revoked.
- No MNRL record found — No revocation history exists for the number.
All successful responses include the phone number, revocation status, and relevant month/year information for tracking purposes.
Last updated 4 weeks ago
Built with Documentation.AI