Submit Fraud Report

Report a fraud incident to the shared fraud database.

Try it

Sandbox returns deterministic mock data, no wallet charge. Checking Live availability…

Request body

Body parameters

Field	Type	Description
`first_name`required	string	Suspect first name.
`last_name`required	string	Suspect last name.
`country`required	string	Country where the fraud occurred.
`fraud_category`required	string	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.

Example responses

200 · Created

{
  "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"
}

400 · Bad request

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

401 · Unauthorized

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

Runs use your signed-in session. For system-to-system integration, issue a keypair in the Console and send Authorization: Bearer <client_id>:<secret> against https://credit.farmsky.africa (Sandbox https://sandbox.credit.farmsky.africa).