v1

latestOpenAPI 3.1.12026-07-2682224.4 KB

List billing records

Returns a paginated list of billing records for the authenticated user, with optional filters (type, date range, status, payment method) and sorting.

get/client/v1/billings/get-list

limitinteger

Maximum number of items to return per page. Default: 30

pageinteger

Requested page number (1-based). Default: 1

typeinteger

Billing record type. 1: Purchase, 2: Wallet top-up

start_datestring

Filter by start date (YYYY-MM-DD), e.g., 2025-08-01

end_datestring

Filter by end date (YYYY-MM-DD), e.g., 2025-08-30

sort_bystring

Field to sort by: id, amount, number_of_ips. Default: id

order_bystring

Sort order: desc or asc. Default: desc

statusinteger

Billing status. 0: pending, 1: success, -1: failed

payment_methodinteger

Filter by payment method.

Successful response

successboolean

Indicates whether the request was successful.

messagestring

Human-readable response message.