Intelligence Search Playground
Search instantaneously across 1.11 Billion records with high-speed query engine
↵ ENTER
Your Production API Key
Use this private key in your HTTP requests header X-API-Key
md_live_••••••••••••••••••••••••
ACTIVE & SECURED
DAILY
Subscription Tier
100 / day
Assigned Limit
0
Queries Used (Current Period)
100
Queries Remaining
Quota Usage
Lifetime Total: 0 searches
Developer REST API Documentation
Direct REST API access across 1.11 Billion Indian telecom records with instant response times.
API Status: Online ⚡
GET / POST
https://asdocs.duckdns.org/api/v1/search
Required Request Headers
| Header Name | Value / Format | Description |
|---|---|---|
X-API-Key Required |
<YOUR_API_KEY> |
Your live authentication key. (Alternatively pass as URL parameter ?api_key=...) |
Content-Type |
application/json |
Required when sending POST request body. |
Accept |
application/json |
Server returns standard UTF-8 JSON. |
🚀 Code Integration by Platform
📋 Query Parameters Reference
All parameters can be sent as URL Query String (GET) or JSON Body (POST).
| Parameter | Type | Speed | Description | Example |
|---|---|---|---|---|
mobile |
String (10 digits) | ⚡ Ultra-Fast (<1s) | 10-digit primary mobile number. Uses high-speed primary index. | 9876543210 |
name |
String | Fast (~1-2s) | Customer full name or partial name (case-insensitive). | Rohit Sharma |
fname |
String | Fast (~1-2s) | Father's name (case-insensitive). | Ram Kumar |
address |
String | Fast (~1-2s) | Address, street, city, state, or PIN code. | Sector 18 Noida |
circle |
String | Fast (~1-2s) | Telecom Circle / Operator circle. | AIRTEL DELHI |
alt |
String | Exact Filter | Alternate mobile number. | 9811002233 |
id |
String | Exact Filter | Document ID / Aadhaar / PAN / Reference ID. | 886553666165 |
email |
String | Fast | Email address. | user@example.com |
limit |
Integer (1 - 1000) | - | Maximum records per page. Default: 100. |
50 |
page |
Integer (≥ 1) | - | Page number for pagination. Default: 1. |
1 |
📦 API Response Structure (JSON)
Every response returns a structured JSON payload with execution latency and remaining quota information.
{
"success": true,
"created_by": "Asdocs & Lucifer",
"data": [
{
"mobile": "9876543210",
"name": "Dev Jyoti Roy",
"fname": "Salil Kumar Roy",
"address": "Tower 9 Flat 1506 Lotus Boulevard Noida Sector 100 Uttar Pradesh 201301",
"circle": "AIRTEL DELHI",
"email": "devjroy@gmail.com",
"alt": "9810012345",
"id": "886553666165",
"record_type": "primary"
},
{
"mobile": "9810012345",
"name": "Dev Jyoti Roy (Alt)",
"fname": "Salil Kumar Roy",
"address": "Tower 9 Flat 1506 Lotus Boulevard Noida Sector 100 Uttar Pradesh 201301",
"circle": "AIRTEL DELHI",
"email": "devjroy@gmail.com",
"alt": "9876543210",
"id": "886553666165",
"record_type": "alt_linked",
"linked_via": "9810012345"
}
],
"total": 2,
"primary_count": 1,
"alt_linked_count": 1,
"alt_numbers_found": ["9810012345"],
"page": 1,
"pages": 1,
"per_page": 100,
"time_ms": 940,
"query_type": "mobile",
"quota": {
"type": "daily",
"limit": 500,
"used": 14,
"remaining": 486
}
}
Response Fields Explanation
success:trueif search completed successfully,falseon error.created_by: API creator & platform attribution ("Asdocs & Lucifer").data: Combined array of matched customer records (both direct primary hits and auto-fetched alternate number records).data[].record_type:"primary"for original matched record, or"alt_linked"for profiles discovered via the Alternate Mobile number.alt_linked_count: Total profiles discovered by auto-searching the alternate number.alt_numbers_found: List of unique 10-digit alternate mobile numbers searched.total: Total matching records found across primary and linked search.time_ms: Execution time in milliseconds (e.g.940ms).quota.type: Quota plan (daily,monthly, orunlimited).quota.remaining: Remaining searches before quota resets.
⚠️ HTTP Status & Error Codes
| Status Code | Status Name | Cause / Error Message | Resolution |
|---|---|---|---|
| 200 OK | Success | Query executed successfully with data returned. | Process data array in your app. |
| 400 Bad Request | Invalid Arguments | No search criteria provided |
Supply at least mobile, name, or filter. |
| 401 Unauthorized | Authentication Failed | Missing or invalid API Key |
Check that X-API-Key header matches your dashboard key. |
| 429 Too Many Requests | Quota Limit Exceeded | Daily quota limit of X queries exceeded |
Wait for auto-reset (midnight UTC for daily, 1st of month for monthly) or contact admin. |
| 500 Server Error | Internal Failure | Internal server or query timeout |
Retry request or check server status. |
Update Account Password
Users can securely change their own password by providing their current password.