Bulk Inquiry

Fetch all settled transactions for your institution on a given date. Useful for daily reconciliation — call once per day (or periodically) to sync settled transaction records with your system.

Authentication

Pass these two headers on every request to secure web service access.

usernameProvided by Kuickpay. String (AlphaNumeric), max 20 characters.

passwordProvided by Kuickpay. String (AlphaNumeric), max 20 characters.

Request Parameters

Parameter	Type	Required	Max Length	Description
`institutionID`	string	required	5	Your Kuickpay institution ID.
`transactionDate`	string	required	8	Date to fetch settled transactions for, format yyyyMMdd (e.g. "20260831").

Response — Success (00)

{
  "response_Code": "00",
  "transactionList": [
    {
      "consumer_Number": "0000812345",
      "registrationNumber": "",
      "transaction_Date_Time": "2023-05-15T00:25:13.71",
      "settlement_Date_Time": "2023-05-15T00:25:13.71",
      "amountTransaction": 330.0000,
      "authID": "788895",
      "bank": "TMF",
      "isSettled": true
    }
  ],
  "count": "01"
}

Response Parameters

Parameter	Type	Required	Max Length	Description
`response_Code`	string	required	2	"00" success. "01" a required parameter was sent blank. "04" wrong username/password. "05" processing/service failure.
`transactionList`	array	required	—	Array of settled transactions for the given date. Empty array if none.
`count`	number	required	—	Number of transactions returned, as a zero-padded string (e.g. "01").

Response Codes

Code	Meaning
00	Successful response. Check transactionList for results.
01	Invalid — a required parameter was sent blank.
04	Wrong credentials — username/password do not match.
05	Processing/service failed — unknown error.

Get available billers

Get Billers →

Bulk Inquiry — Request

curl -X POST https://uat-adminapi.kuickpay.com/api/BillPaymentBulkInquiry \
  -H "username: Test" \
  -H "password: Test123" \
  -H "Content-Type: application/json" \
  -d '{
    "institutionID": "00008",
    "transactionDate": "20230505"
  }'