ZamuPay API Documentation
    ZamuPay API Documentation
    • Zamupay overview
    • Token Request
      POST
    • Payment Order Request
      POST
    • Reject Order By OriginatorConversationId
      POST
    • Express Deposit Request
      POST
    • Find Payment Order By OriginatorConversationId
      GET
    • Find Express Deposit By OriginatorConversationId
      GET
    • Bill Number
      POST
    • Find Bill Number By Service Id and Account Number
      GET
    • Find Transaction Routes
      GET
    • Find Charges By TransactionTypeId
      GET
    • Bill Request
      POST
    • Find Bill Request By Originator Converstion Id
      GET
    • Find Bill Services
      GET
    • Account Number Validation Request
      POST
    • Find Account Validation Status by SystemTraceAuditNumber
      GET
    • Airtime Purchase
      POST
    • Find Airtime Purchases By OriginatorConversationId
      GET
    • Health Check
      GET
    • Create Payment Link
      POST
    • Find Payment Links By Id
      GET
    • Update Payment Link
      PUT
    • KYC Validation
      POST
    • KYC Validation
      GET
    • Balance Check
      GET

      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 2025-12-09 12:39:20
      Previous
      Bill Number
      Next
      Find Transaction Routes
      Built with