Courier Fraud Checker API Documentation

Introduction

The Courier Fraud Checker API allows you to programmatically check the delivery reliability and fraud risk associated with phone numbers used for courier services in Bangladesh.

This API aggregates data from multiple courier services including Pathao, Steadfast, PaperFly, and Redx to provide comprehensive delivery statistics and risk assessments.

Base URL

All API requests should be made to:

https://api.dsxup.eu.org/courier/fraud-check.php

Authentication

Currently, this API is publicly accessible and does not require authentication. However, we recommend implementing rate limiting in your client applications.

Note

Authentication may be required in future versions of the API. We will provide ample notice before any changes.

API Endpoints

GET

Check Phone Number

Retrieve delivery statistics and risk assessment for a specific phone number.

GET /api.php?phone=01712345678

Query Parameters

Parameter	Required	Type	Description
phone	Yes	String	A valid Bangladeshi mobile number (11 digits, starting with 01)

Making Requests

All API requests should be made using HTTP GET method. The API accepts query parameters and returns JSON responses.

Example Request

curl -X GET "https://api.dsxup.eu.org/courier/fraud-check.php?phone=01712345678"

Response Format

All successful API responses return a JSON object with the following structure:

{
  "success": true,
  "developer": "DSX-SPA",
  "source": "fraudchecker.link",
  "checkedAt": "2025-09-29T22:38:32+00:00",
  "data": {
    "checkedNumber": "01712345678",
    "deliverySuccessRatio": "14.29%",
    "riskAssessment": {
      "level": "High Risk",
      "message": "এই মানুষ কে পার্সেল ডেলিভার করা অনেকটাই রিস্কি।"
    },
    "overallStats": {
      "totalOrders": 28,
      "totalDeliveries": 4,
      "totalCancellations": 24
    },
    "courierStats": {
      "Pathao": {
        "orders": 14,
        "delivered": 2,
        "cancelled": 12,
        "deliveryRate": "14.29%"
      },
      "Steadfast": {
        "orders": 7,
        "delivered": 1,
        "cancelled": 6,
        "deliveryRate": "14.29%"
      },
      "PaperFly": {
        "orders": 0,
        "delivered": 0,
        "cancelled": 0,
        "deliveryRate": "N/A"
      },
      "Redx": {
        "orders": 7,
        "delivered": 1,
        "cancelled": 6,
        "deliveryRate": "14.29%"
      }
    },
    "merchantReports": []
  }
}

Response Fields

Field	Type	Description
success	Boolean	Indicates if the request was successful
data.checkedNumber	String	The phone number that was checked
data.deliverySuccessRatio	String	Overall delivery success rate across all couriers
data.riskAssessment	Object	Risk level and message indicating delivery risk
data.courierStats	Object	Detailed statistics for each courier service

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of requests. When an error occurs, the response will include a JSON object with error details.

{
  "success": false,
  "error": "A valid Bangladeshi phone number (e.g., 01712345678) is required."
}

Common HTTP Status Codes

Status Code	Meaning
200 OK	The request was successful
400 Bad Request	The request was invalid (e.g., missing or malformed phone number)
500 Internal Server Error	An error occurred on the server while processing the request

Code Examples

Here are examples of how to use the Courier Fraud Checker API in different programming languages:

JavaScript (Fetch)

fetch('https://api.dsxup.eu.org/courier/fraud-check.php?phone=01712345678')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

PHP (cURL)

$phone = '01712345678';
$url = "https://api.dsxup.eu.org/courier/fraud-check.php?phone=" . urlencode($phone);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

Python (Requests)

import requests

response = requests.get(
    "https://api.dsxup.eu.org/courier/fraud-check.php",
    params={"phone": "01712345678"}
)
data = response.json()

cURL

curl -X GET "https://api.dsxup.eu.org/courier/fraud-check.php?phone=01712345678"

Documentation

API Status