NetConnect API Docs

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,
    "status": "completed"
  }
}

Response fields

Field	Type	Notes
`transactions`	array	Array of transaction objects
`totalAmount`	number	Total GHS charged across all transactions
`status`	string	Always `"completed"` — all credentials are issued synchronously

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 purchase
402 - Insufficient wallet balance
400 - Invalid request or validation failed

Sample request

POST/api/v1/result-checker/buy-bulktry·it·live

request body · json

✓ valid

⚠ no api key set — request will use placeholder

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"
    }
  ]
}'

Buy Bulk Result Checker Packages