Get started


    API Endpoint

        https://riskdbbd.com/api
                

The API provides programmatic access in RiskDB database. User can check risk score using email/mobile, user also can report COD events (fail/success), Payment Issue.

To use this API, you need an API key. Please contact us at riskdb@bluedot.ltd to get your own API key.

RiskDB is a cloud-sourced risk assessment service developed by Bluedot Technology Ltd. RiskDB collects name, email, mobile number from the API user (willing submission). We store data without identifying API users. RiskDB performs IP check but doesn't store any IP data in our system. This data is not 100% accurate, as we rely on voluntary data contributions.

Authentication: RiskBD uses a simple API token-based authentication to validate requests. You can add the API token in the request header as "Authorization: Bearer" or with adding api_token in GET/POST parameter.

Wordpress Plugin

get risk score



# Here is a php example

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://riskdbbd.com/api/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => http_build_query([
    'mobile'=>'01950XXXX51', 
    'ip'=> '127.0.0.1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer YOUR_API_KEY"
  ]
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
                

To get characters you need to make a GET/POST call to the following url :
https://riskdbbd.com/api/check



Result example :

{
    "status": "available",
    "names": [
        "Saiful Islam",
        "সাইফুল ইসলাম"
    ],
    "mobiles": [
        "01950XXXX51",
        "01950XXXX61",
        "01950XXXX91"
    ],
    "emails": [
        "mail1@admin.com",
        "mail2@admin.com",
        "mail3@admin.com",
        "mail4@admin.com",
    ],
    "risk": {
        "cod_success": "73% / 5",
        "cod_fail": "0% / 0",
        "paymnet_issue": "27% 2"
    },
    "ip": {
        "ip": "XXX.XXX.XXX.XXX",
        "iso-code": "BD",
        "country": "Bangladesh",
        "state": "Dhaka",
        "state_iso": "13",
        "postcode": "1000",
        "latitude": 23.7272,
        "longitude": 90.4093,
        "network": "XXX.XXX.XXX.XXX/24"
    }
}
                

QUERY PARAMETERS

Field Type Description
mobile/email String Clients Mobile or Email
ip String (optional) clients ip address:

submit order events


# Here is a php example

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://riskdbbd.com/api/event",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => http_build_query([
    'name'=>'Saiful Islam', 
    'mobile'=>'01950XXXX51', 
    'email'=> 'mail@mail.com',
    'type'=> 'success'
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer YOUR_API_KEY"
  ]
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
                

To get characters you need to make a GET/POST call to the following url :
https://riskdbbd.com/api/event



Result example :

**ok**
                

QUERY PARAMETERS

Field Type Description
name String Clients Full Name
mobile String Clients Mobile Number
email String Clients Email Address
type String Event Type (success|failed|payment)

Type: success = Cash on Delivery Successful
Type: failed = Cash on Delivery Failed
Type: payment = Payment Issue / Fraud / Scammer