/v3/fraud/bulk-scan/upload
identity:read
Fraud Bulk Scan Upload
Kick off a bulk fraud scan job.
Try it
Sandbox returns deterministic mock data, no wallet charge. Checking Live availability…
Request body
Body parameters
| Field | Type | Description |
|---|---|---|
scan_typerequired |
string | Scan type (e.g. face_scan | id_scan). |
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,
"bulk_id": "BULK-77",
"message": "Request successful",
"data": {
"bulk_id": "BULK-77",
"status": "processing"
},
"provider": "Farmsky Verify",
"record_id": "rec_1f4c9a20b8d34e77"
}
400 · Bad request
{
"error": "invalid_request",
"message": "scan_type is 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).