/v3/background/candidates/:reference/reinitiate
identity:read
Reinitiate Candidate Request
Re-run a candidate request that stalled or expired.
This endpoint has a path parameter. Call it from your own client using the reference below.
Body parameters
| Field | Type | Description |
|---|---|---|
callback_url |
string | Your webhook URL. |
Path parameters
| Field | Type | Description |
|---|---|---|
referencerequired |
string | Unique reference of the candidate request. |
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,
"reference": "CAND-REF-9",
"message": "Request successful",
"data": {
"reference": "CAND-REF-9",
"status": "reinitiated"
},
"provider": "Farmsky Verify",
"record_id": "rec_1f4c9a20b8d34e77"
}
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).