/v3/background/packages
identity:read
Create Custom Package
Create a custom background-check package.
Try it
Sandbox returns deterministic mock data, no wallet charge. Checking Live availability…
Request body
Body parameters
| Field | Type | Description |
|---|---|---|
countryrequired |
string | ISO-3166 alpha-3 country code (e.g. NGA). |
allow_candidate_payment |
boolean | Whether candidates can pay for their own checks. |
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,
"id": "pkg-cust-1",
"message": "Request successful",
"data": {
"id": "pkg-cust-1",
"country": "NGA"
},
"provider": "Farmsky Verify",
"record_id": "rec_1f4c9a20b8d34e77"
}
400 · Bad request
{
"error": "invalid_request",
"message": "country 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).