REST API v1

FraudSpy API

Check delivery risk from your own app, ERP or checkout. Every call is billed from your FraudSpy wallet at the standard per-search rate.

Base URL

https://fraudspy.zeroo.click/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

HTTPMeaning
401Missing / invalid / revoked API key
402Insufficient wallet balance
403IP not allowed for this key
422Invalid phone number
429Rate limit or daily quota exceeded
503All couriers unreachable (you are not charged)

Examples

cURL

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

PHP

$ch = curl_init("https://fraudspy.zeroo.click/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://fraudspy.zeroo.click/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://fraudspy.zeroo.click/api/v1/fraud-check",
  headers={"X-API-Key": "ng_live_xxx"},
  json={"phone": "01897216101"})
print(r.json())

🧩 Ready-made integrations

Plug FraudSpy into the tools you already use — no custom coding needed for these.

Google Sheets

Custom =FRAUDSPY_RISK(A2) formula + a bulk-check menu, right inside your spreadsheet.

Download Apps Script (.gs)
  1. Sheet → Extensions → Apps Script
  2. Paste the downloaded file's contents, Save
  3. Reload the sheet → "FraudSpy" menu → Set API Key
WordPress / WooCommerce

Shows a live risk badge on checkout and a Delivery Risk column on WooCommerce orders.

Download Plugin
  1. Download, then rename to fraudspy-wp.php
  2. Upload to wp-content/plugins/ (or zip it and use Plugins → Add New → Upload)
  3. Activate → Settings → FraudSpy → paste your API key
Chrome Extension

Check any number from a popup while browsing — right-click selected text to check it instantly.

  1. Create a local folder, download all 4 files into it
  2. Rename each — drop the ext- prefix (manifest.json, popup.html, popup.js, background.js)
  3. Chrome → chrome://extensions → enable Developer Mode → Load unpacked → select the folder
Shopify

Two options: a checkout-page snippet, or a webhook that auto-tags risky orders on any Shopify plan.

  1. Snippet: Settings → Checkout → Order status page → Additional scripts → paste
  2. Webhook: rename to .php, host it yourself, fill in your Shopify + FraudSpy keys, then Settings → Notifications → Webhooks → Order creation → your URL
REST API

Full docs above — works from any language: PHP, Node, Python, or your ERP's HTTP client.

See API docs ↑

Android app is in active development and not yet published — this page will be updated the moment it's live.

Need higher limits or a dedicated integration? Contact us.