1. Bill Payments
ZamuPay API Documentation
  • Introduction
  • Definitions
    • Data Types
  • Authorization
    • Overview
    • Token Request
      POST
    • Find Transaction Routes
      GET
    • Health Check
      GET
  • Checkout Request
    • Overview
    • Checkout Order Request
      POST
    • Query Checkout Request
      GET
    • Checkout Callback Request
      POST
  • Payment Request
    • Payment Order Request
      POST
    • Reject Order By OriginatorConversationId
      POST
    • Find Payment Order By OriginatorConversationId
      GET
  • Collection Request
    • Find Express Deposit By OriginatorConversationId
      GET
    • Express Deposit Request
      POST
  • Bill Payments
    • Bill Number
      POST
    • Find Bill Number By Service Id and Account Number
      GET
    • Bill Request
      POST
    • Find Bill Request By Originator Converstion Id
      GET
    • Find Bill Services
      GET
  • KYC
    • Account Number Validation Request
      POST
    • KYC Validation
      POST
    • KYC Validation
      GET
    • Find Account Validation Status by SystemTraceAuditNumber
      GET
  • Payment Links
    • Find Payment Links By Id
    • Create Payment Link
    • Update Payment Link
  • Customer Accounts
    • Balance Check
    • Find Charges By TransactionTypeId
  • Airtime Purchase
    • Airtime Purchase
    • Find Airtime Purchases By OriginatorConversationId
  1. Bill Payments

Find Bill Number By Service Id and Account Number

https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
GET
/v1/bill-numbers
This is a GET request that returns the saved billing information using the serviceId and accountNumber

serviceId: This is a number that represents the different services available. Check the table Services for the list of service Ids
accountNumber: Account number reference for pay bill transactions.

Sample success response:
#

{
"serviceID": 1,
"customerName": "BENSON OKIORA",
"accountNumber": "1049928063",
"phoneNumber": "254718621991",
"enabled": true,
"verified": true,
"dueDate": "2021-10-18 00:00:00",
"lastKnownBalance": 2697.00,
"remindMeDueDate": true,
"remarks": "Test Benson's DSTV"
}

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://auth.zamupay.com/v1/bill-numbers?ServiceCode&AccountNumber' \
--header 'Authorization: Bearer <token>'
Response Response Example
{}
Modified at 2026-01-29 06:17:10
Previous
Bill Number
Next
Bill Request
Built with