Result Checker
Buy Bulk Result Checker Packages
Deduct wallet balance once and allocate multiple credentials in one call.
Endpoint
POST /api/v1/result-checker/buy-bulk
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
items | array | Yes | Between 1 and 20 result checker requests |
Each items[] entry contains:
| Field | Type | Required | Notes |
|---|---|---|---|
packageId | rcPackages id | Yes | Requested package |
recipientPhone | string | Yes | Destination phone number |
Response
Returns an array of completed transactions with credentials:
{
"success": true,
"data": {
"transactions": [
{
"transactionId": "rc9exampletxn1",
"recipientPhone": "233201234567",
"credential": {
"username": "candidate-user-1",
"password": "candidate-pass-1"
}
},
{
"transactionId": "rc9exampletxn2",
"recipientPhone": "233209876543",
"credential": {
"username": "candidate-user-2",
"password": "candidate-pass-2"
}
}
],
"totalAmount": 10.00
}
}Response fields
| Field | Type | Notes |
|---|---|---|
transactions | array | Array of transaction objects |
totalAmount | number | Total GHS charged across all transactions |
Transaction object fields
| Field | Type | Notes |
|---|---|---|
transactionId | string | rcTransactions record ID |
recipientPhone | string | Recipient phone number |
credential | object | Login credentials assigned to this recipient |
Credential object
| Field | Type | Notes |
|---|---|---|
username | string | Login username |
password | string | Login password |
Constraints
- Minimum 1 recipient
- Maximum 20 recipients
- Each request is validated independently
- Single wallet debit for total amount
- Partial failures are reported but not rolled back
Errors
403- Only Agent and SuperAgent can purchase402- Insufficient wallet balance400- Invalid request or validation failed
Sample request
curl -X POST "https://api.netconnectgh.online/api/v1/result-checker/buy-bulk" \
-H "X-API-KEY: netconnect_live_your_secret_here" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"packageId": "rcpkgexample123",
"recipientPhone": "233201234567"
},
{
"packageId": "rcpkgexample456",
"recipientPhone": "233209876543"
}
]
}'