APIs for Businesses
Home
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
Home
APIs
  • Checkout/ Deeplink
  • Merchant Proxy
  • Bill24 Hosted
  • Auto Direct Debit
  • KHQR Integration Specification for API
  • Notification API
  • On Boarding Sub Biller API
CHECKOUT/ DEEPLINKMerchant ProxyBill24 HostedAuto Direct DebitKHQR Integration Specification for APINotification APIPayment Method
CHECKOUT/ DEEPLINKMerchant ProxyBill24 HostedAuto Direct DebitKHQR Integration Specification for APINotification APIPayment Method
  1. Get Bills
  • Payment Method API
    • Overview
    • Response Code
    • MOBILE SDKS
      • iOS SDK
      • Android SDK
    • Authorization
      • Authorization
    • Customer
      • Get Customer Details
      • Update Customer
      • Delete Customer
      • Create Customer
    • Get Payment Methods
      • Get Payment Methods
    • Get Wallet Balance
      • Get Wallet Balance
    • Settle Payment
      • Settle Payment
    • Get Bills
      • Get list bills
        GET
      • Get single bill
        GET
    • Get transaction Details
      • Get Transaction Detail
  • Activate Sub Biller API
    • Overview
    • Response Code
    • Authorization
      POST
    • Onboarding
      POST
    • Get Available Banks
      GET
    • Add Link Account
      POST
    • Verify Linked Bank Account
      POST
  1. Get Bills

Get list bills

GET
https://merchantapi-demo.bill24.io/instant_payment/get_bills
This endpoint use to get list invoice of customer
The parameter FromDate and ToDate is required to be include in the the request URL.

Request

Query Params
from_date
string 
required
Start Date
Example:
2024-05-01
to_date
string 
required
End Date
Example:
2025-07-01
Currency
string 
optional
Currency
Example:
KHR
customer_sync_code
string 
optional
Customer sync Code from Biller side
Example:
C0020
page_index
string 
optional
The position of the page.
page_size
string 
optional
Number of items per page.
Header Params
Content-Type
string 
required
Example:
application/json
Authorization
string 
required
Example:
Bearer {token get from endpoint (Authorization)}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://merchantapi-demo.bill24.io/instant_payment/get_bills?from_date=2024-05-01&to_date=2025-07-01&Currency=KHR&customer_sync_code=C0020&page_index&page_size' \
--header 'Authorization:  Bearer {token get from endpoint (Authorization)}' \
--header 'Content-Type: application/json'

Responses

🟢200Success
application/json
Body
code
string 
optional
Response Code
message
string 
optional
Response message in English
message_kh
string 
optional
Response message in khmer
data
object 
optional
pagination
object 
optional
bills
array [object {10}] 
optional
Example
{
    "code": "000",
    "message": "Success",
    "message_kh": "ជោគជ័យ",
    "data": {
        "pagination": {
            "page_index": 1,
            "page_size": 10,
            "page_count": 1,
            "row_count": 625
        },
        "bills": [
            {
                "ref_id": "R0-94754",
                "date": "2025-07-08T00:00:00",
                "due_date": "2025-07-15T00:00:00",
                "description": "tesing with CPO19",
                "currency": "KHR",
                "total_amount": 1000,
                "customer_sync_code": "C0020",
                "bill_status": "paid",
                "details": [
                    {
                        "item_name": "100KWh",
                        "description": "for charge",
                        "quantity": 1,
                        "price": 1000,
                        "amount": 1000
                    }
                ],
                "payment": {
                    "checkout_link": "https://checkout-demo.bill24.io/checkoutv2/2000000000002686891",
                    "checkout_ref": "2000000000002686891",
                    "payment_date": "2025-07-08T22:46:10.243324",
                    "payment_method": "wallet"
                }
            },
            {
                "ref_id": "B006",
                "date": "2025-07-08T00:00:00",
                "due_date": "2025-07-28T00:00:00",
                "description": "upload bills",
                "currency": "KHR",
                "total_amount": 10000,
                "customer_sync_code": "CS004",
                "bill_status": "paid",
                "details": [
                    {
                        "item_name": "",
                        "description": "ការប្រើប្រាស់ ថាមពលសាកថ្ម",
                        "quantity": 10,
                        "price": 100,
                        "amount": 1000
                    },
                    {
                        "item_name": "A002",
                        "description": "ការប្រើប្រាស់ ថាមពលសាកថ្ម",
                        "quantity": 1,
                        "price": 9000,
                        "amount": 9000
                    }
                ],
                "payment": {
                    "checkout_link": "https://checkout-demo.bill24.io/checkoutv2/2000000000002686892",
                    "checkout_ref": "2000000000002686892",
                    "payment_date": "2025-07-08T22:54:19.626169",
                    "payment_method": "wallet"
                }
            }
        ]
    }
}
Modified at 2025-07-08 17:32:13
Previous
Settle Payment
Next
Get single bill