NexGuard API

Base URL

https://fraud.playboostup.com/api/v1

Authentication

Create a key in Dashboard → API Keys. Send it on every request:

X-API-Key: ng_live_xxxxxxxxxxxxxxxxxxxx

Keys are rate-limited (default 60/min) and can be locked to specific IPs.

POST /fraud-check

Check one phone number. Charges your wallet on success.

Request

{
  "phone": "01897216101",
  "couriers": ["all"]        // or ["steadfast","pathao"]
}

Response 200

{
  "success": true,
  "data": {
    "phone": "01897216101",
    "success_rate": 87,
    "risk": "low",
    "total_orders": 100, "delivered": 87,
    "returned": 13, "cancelled": 0,
    "courier_breakdown": { "steadfast": { "total_orders": 60, "delivered": 55, ... } }
  },
  "meta": { "cost": 0.5, "balance_after": 124.5, "charged": true }
}

POST /bulk-check

{ "phones": ["017...", "018..."], "couriers": ["all"] }

Max 500 per request. Quota & balance are checked for the whole batch; partial success is allowed. Returns { success, results: [...], meta }.

GET /balance  ·  GET /usage  ·  GET /health

{ "success": true, "balance": 124.50, "currency": "BDT" }

/usage returns today's and this month's call count + spend.

Errors

Examples

cURL

curl -X POST https://fraud.playboostup.com/api/v1/fraud-check \
  -H "X-API-Key: ng_live_xxx" -H "Content-Type: application/json" \
  -d '{"phone":"01897216101"}'

PHP

$ch = curl_init("https://fraud.playboostup.com/api/v1/fraud-check");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["X-API-Key: ng_live_xxx", "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["phone" => "01897216101"]),
  CURLOPT_RETURNTRANSFER => true,
]);
$res = json_decode(curl_exec($ch), true);

JavaScript

const r = await fetch("https://fraud.playboostup.com/api/v1/fraud-check", {
  method: "POST",
  headers: { "X-API-Key": "ng_live_xxx", "Content-Type": "application/json" },
  body: JSON.stringify({ phone: "01897216101" })
});
const data = await r.json();

Python

import requests
r = requests.post("https://fraud.playboostup.com/api/v1/fraud-check",
  headers={"X-API-Key": "ng_live_xxx"},
  json={"phone": "01897216101"})
print(r.json())