Fraud Scan

Submit Fraud Report

POST https://credit.farmsky.africa/v3/fraud/reports

Report a fraud incident to the shared fraud database.

identity:read

Headers

Authorization string required Defaults to Bearer {CLIENT_ID}:{CLIENT_SECRET}

Your API client id and secret, joined by a colon. Manage credentials in the Console.

x-api-key string optional Defaults to {API_KEY}

Alternative single-value secret key header (equivalent to X-Api-Secret). Never expose it in client-side code.

Content-Type string required Defaults to application/json

All request bodies are JSON unless the endpoint accepts multipart/form-data (file uploads).

Body Params

first_name string required

Suspect first name.

last_name string required

Suspect last name.

country string required

Country where the fraud occurred.

fraud_category string required

Category of fraud (enum).

fraud_type string

Specific fraud type.

date_of_fraud string

Date the fraud occurred (YYYY-MM-DD).

description string

Description of the incident.

evidence_files array

URLs of evidence files.

API Request Examples

curl --request POST \
  --url https://credit.farmsky.africa/v3/fraud/reports \
  --header 'Authorization: Bearer {CLIENT_ID}:{CLIENT_SECRET}' \
  --header 'x-api-key: {API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{"first_name":"John","last_name":"Doe","country":"Nigeria","fraud_category":"banking","fraud_type":"Account takeover","date_of_fraud":"2024-11-20","description":"Unauthorized account access and transfer."}'

const res = await fetch('https://credit.farmsky.africa/v3/fraud/reports', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {CLIENT_ID}:{CLIENT_SECRET}',
    'x-api-key': '{API_KEY}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "first_name": "John",
    "last_name": "Doe",
    "country": "Nigeria",
    "fraud_category": "banking",
    "fraud_type": "Account takeover",
    "date_of_fraud": "2024-11-20",
    "description": "Unauthorized account access and transfer."
  }),
});
const data = await res.json();
console.log(data);

import requests

url = "https://credit.farmsky.africa/v3/fraud/reports"
headers = {
    "Authorization": "Bearer {CLIENT_ID}:{CLIENT_SECRET}",
    "x-api-key": "{API_KEY}",
    "Content-Type": "application/json",
}
payload = {
    "first_name": "John",
    "last_name": "Doe",
    "country": "Nigeria",
    "fraud_category": "banking",
    "fraud_type": "Account takeover",
    "date_of_fraud": "2024-11-20",
    "description": "Unauthorized account access and transfer."
}
resp = requests.post(url, headers=headers, json=payload)
print(resp.json())

<?php
$ch = curl_init();
curl_setopt_array($ch, [
  CURLOPT_URL => "https://credit.farmsky.africa/v3/fraud/reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer {CLIENT_ID}:{CLIENT_SECRET}",
    "x-api-key: {API_KEY}",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
  "first_name" => "John",
  "last_name" => "Doe",
  "country" => "Nigeria",
  "fraud_category" => "banking",
  "fraud_type" => "Account takeover",
  "date_of_fraud" => "2024-11-20",
  "description" => "Unauthorized account access and transfer."
]),
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String payload = "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"country\":\"Nigeria\",\"fraud_category\":\"banking\",\"fraud_type\":\"Account takeover\",\"date_of_fraud\":\"2024-11-20\",\"description\":\"Unauthorized account access and transfer.\"}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://credit.farmsky.africa/v3/fraud/reports"))
    .header("Authorization", "Bearer {CLIENT_ID}:{CLIENT_SECRET}")
    .header("x-api-key", "{API_KEY}")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	payload := strings.NewReader(`{"first_name":"John","last_name":"Doe","country":"Nigeria","fraud_category":"banking","fraud_type":"Account takeover","date_of_fraud":"2024-11-20","description":"Unauthorized account access and transfer."}`)
	req, _ := http.NewRequest("POST", "https://credit.farmsky.africa/v3/fraud/reports", payload)
	req.Header.Add("Authorization", "Bearer {CLIENT_ID}:{CLIENT_SECRET}")
	req.Header.Add("x-api-key", "{API_KEY}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

RESPONSE

{
  "request_id": "req_8f2c1a9b7d3e4f60",
  "live": true,
  "ok": true,
  "response_code": "00",
  "status": "VERIFIED",
  "found": true,
  "soft_error": false,
  "async_pending": false,
  "report_id": "Fraud-4190",
  "message": "Request successful",
  "data": {
    "report_id": "Fraud-4190",
    "status": "submitted"
  },
  "provider": "Farmsky Verify",
  "record_id": "rec_1f4c9a20b8d34e77"
}

{
  "error": "invalid_request",
  "message": "first_name, last_name, country and fraud_category are required"
}

{
  "error": "unauthorized",
  "message": "API credentials required. Send Authorization: Bearer <client_id>:<secret>."
}