REST API Reference

Adeel Simdatabase
API Documentation

Free, zero-authentication REST API for Pakistan SIM & CNIC owner lookup. JSON responses, instant results.

Live & Free
๐Ÿ“„ JSON ๐Ÿ”“ No Auth โšก <1s
Base URL https://adeel.app
๐Ÿ“ก Endpoints
GET /api/search?phone={number}
๐Ÿ”— https://adeel.app/api/search?phone=03465563576
โ„น๏ธAccepts all Pakistan formats: 03XXXXXXXXX (11 digits), 3XXXXXXXXX (10 digits), or 923XXXXXXXXX (12 digits). Auto-normalized.
ParameterTypeRequired
phonestringRequired
Pakistan mobile number โ€” formats: 03XX / 3XX / 92XX
๐Ÿ“Œ Request
HTTP
GET https://adeel.app/api/search?phone=03465563576
โœ… Response 200
JSON
{
  "success": true,
  "type": "phone",
  "data": {
    "Name": "YOUSAF KHAN",
    "CNIC": "1430158633765",
    "Mobile": "3465563576",
    "ADDRESS": "KOHAT"
  }
}
GET /api/search?cnic={cnic}
๐Ÿ”— https://adeel.app/api/search?cnic=1430158633765
โ„น๏ธReturns all SIM numbers registered against the provided CNIC. Accepts exactly 13 numeric digits.
ParameterTypeRequired
cnicstringRequired
13-digit Pakistan CNIC number (no dashes)
๐Ÿ“Œ Request
HTTP
GET https://adeel.app/api/search?cnic=1430158633765
โœ… Response 200
JSON
{
  "success": true,
  "type": "cnic",
  "total": 2,
  "data": [
    {
      "Name": "YOUSAF KHAN",
      "Mobile": "3465563576",
      "ADDRESS": "KOHAT"
    }
  ]
}
GET /api/health
๐Ÿ”— https://adeel.app/api/health
๐Ÿ“Œ Request
HTTP
GET https://adeel.app/api/health
โœ… Response 200
JSON
{
  "success": true,
  "status": "healthy",
  "service": "Adeel Simdatabase",
  "timestamp": "2026-06-13T..."
}
โš ๏ธ Error Responses
โŒ 400 โ€” Invalid Input
JSON
{
  "success": false,
  "error": "Invalid phone number..."
}
โŒ 404 โ€” Not Found
JSON
{
  "success": false,
  "error": "No data found..."
}
CodeMeaningWhen
200SuccessData found and returned
400Bad RequestInvalid phone / CNIC format
404Not FoundNo record in database (SIM/CNIC may be post-2022)
502Upstream ErrorData source temporarily unreachable
๐Ÿ’ป Code Examples
๐Ÿ Python
Python
import requests

r = requests.get(
  "https://adeel.app/api/search",
  params={"phone": "03465563576"}
)
data = r.json()
if data["success"]:
  print(data["data"]["Name"])
๐Ÿ“œ JavaScript
JavaScript
fetch("https://adeel.app/api/search?phone=03465563576")
  .then(r => r.json())
  .then(d => {
    if (d.success)
      console.log(d.data.Name);
  });
๐Ÿ“ฑ Node.js (Axios)
Node.js
const axios = require('axios');
const res = await axios.get(
  'https://adeel.app/api/search',
  {params: {phone: '03465563576'}}
);
console.log(res.data.data.Name);
๐Ÿ”ง cURL
Shell
# Phone lookup
curl "https://adeel.app/api/search?phone=03465563576"

# CNIC lookup
curl "https://adeel.app/api/search?cnic=1430158633765"
๐Ÿ˜ PHP
PHP
$url = "https://adeel.app/api/search?phone=03465563576";
$d = json_decode(
  file_get_contents($url), true
);
if($d['success'])
  echo $d['data']['Name'];
๐Ÿ’Ž Ruby
Ruby
require 'net/http'
require 'json'
uri = URI("https://adeel.app/api/search")
uri.query = URI.encode_www_form(
  phone: "03465563576"
)
d = JSON.parse(Net::HTTP.get(uri))
puts d["data"]["Name"] if d["success"]
๐Ÿ‘จโ€๐Ÿ’ป Developer
Developer
Adeel
Telegram
WhatsApp
โš ๏ธ For educational & authorized use only. Respect data privacy laws.