Get Invoices
Retrieves a paginated list of invoices. Supports filtering by store, status, and date range.
When to Use
▾
Use this endpoint when:
- Listing invoices in a dashboard
- Reconciling paid vs pending invoices
- Searching invoices within a date range
Invoice status values: PENDING, PAID, EXPIRED, DELETED.
How to Use
▾
/api/v3/invoices?limit=10&status=PENDING&status=PAID- Send the request with optional filters (
storeId,status,start,end,limit) - Read
itemsfor the invoice list - If
cursoris non-empty, pass it on the next request to fetch the next page
Request Parameters
▾
Filter by store ID
Example: 1608714483132458121
Filter by invoice status. Repeat the param for multiple statuses.
Example: ["PENDING", "PAID"]
Number of records per page
Example: 10
Pagination cursor from the previous response
Example: EgdpbnZvaWNlGKrg...
Filter invoices created from this date time (RFC3339)
Example: 2026-05-18T09:21:19Z
Filter invoices created up to this date time (RFC3339)
Example: 2026-05-19T09:21:19Z
Response Parameters
▾
Cursor for the next page (empty when there are no more results).
List of invoice objects.
Invoice ID.
Merchant-defined reference ID.
Recurring invoice ID (empty if not recurring).
Invoice group ID (empty if standalone).
Merchant ID.
Merchant name.
Merchant logo URL.
Merchant notification email.
Store ID.
Payer email address.
Payer name.
Payer phone number.
Payer country code.
Currency code.
Invoice amount in cents (e.g. 100 = RM 1.00).
Amount paid in cents.
Fees amount in cents.
Net amount received in cents.
Invoice status (PENDING, PAID, EXPIRED, DELETED).
Transaction ID (populated when paid).
Shareable invoice payment URL.
URL to redirect the payer after payment.
Terms and conditions URL.
Additional remarks.
Whether an email notification is sent to the payer.
Email subject.
Invoice description.
Invoice expiry date time (RFC3339).
Payment date time (RFC3339, empty if unpaid).
Invoice creation date time (RFC3339).
Last updated date time (RFC3339).
Custom fields (null if not set; not in use at the moment).