Dashboard Overview

0 Credits
Total Queries 0
Successful Lookups 0
API Keys 0

Last 7 Days Usage

0 queries 0% success rate
Date Lookups Successful Success Rate
Loading usage data...

System Status

Checking... Overall Status
API Server --
Database --

API Keys

Keys are shown only once when created - store them securely!

Loading API keys...

Credits & Billing

Current Balance
0
1 credit = 1 successful lookup

Add Credits

Transaction History

Loading transactions...

Lookup History

Phone Number Results Status API Key Date & Time
Loading lookup history...

Test API

0 Credits

Phone Lookup Test

Test the lookup API with a phone number using your API key.

Paste your full API key here
Supports Egyptian phone formats

Account Settings

Username

Change your display name

Username must be between 3 and 50 characters

Password

Change your account password

Password must be at least 6 characters

Delete Account

Permanently disable your account

Warning: This action will disable your account. You will be logged out and won't be able to access your account. All your API keys will be deactivated.

API Documentation

Authentication

All API requests require an API key in the header:

api-key: your_api_key_here

Phone Lookup

GET /api/lookup?phone={phone_number}

Example Request

curl -X GET "http://app.accunums.com/api/lookup?phone=+201001234567" \
     -H "api-key: cid_your_api_key"
import requests

url = "http://app.accunums.com/api/lookup"
headers = {
    "api-key": "cid_your_api_key"
}
params = {
    "phone": "+201001234567"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

if response.status_code == 200:
    print(f"Found {data['count']} result(s)")
    for result in data['data']:
        print(f"Name: {result['full_name']}")
else:
    print(f"Error: {data.get('detail', 'Unknown error')}")
<?php
$apiKey = "cid_your_api_key";
$phone = "+201001234567";
$url = "http://app.accunums.com/api/lookup?phone=" . urlencode($phone);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "api-key: " . $apiKey
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode === 200) {
    echo "Found " . $data['count'] . " result(s)\n";
    foreach ($data['data'] as $result) {
        echo "Name: " . $result['full_name'] . "\n";
    }
} else {
    echo "Error: " . ($data['detail'] ?? 'Unknown error') . "\n";
}
?>

Example Response

{
  "message": "Success",
  "count": 2,
  "phone_number": "+201001234567",
  "data": [
    {
      "full_name": "John Doe",
      "email": "[email protected]"
    },
    {
      "full_name": "Jane Doe",
      "email": null
    }
  ],
  "credits_remaining": 99
}

Supported Phone Formats

  • +20XXXXXXXXXX - Full international format
  • 0XXXXXXXXXX - With leading zero
  • XXXXXXXXXX - 10 digits only
  • Arabic numerals (٠-٩) are automatically converted

Error Codes

Code Description
400 Missing phone parameter or invalid format
401 Invalid or missing API key
402 Insufficient credits
403 API key disabled
404 No records found

Credits

  • 1 credit = 1 successful lookup
  • Credits are only deducted when results are found
  • Failed lookups (no results) are free

Notifications

Loading notifications...