---
title: "List billing records"
method: GET
path: "/client/v1/billings/get-list"
---

# List billing records

`GET /client/v1/billings/get-list`

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

## Query parameters

- `limit` integer
- `page` integer
- `type` integer
- `start_date` string
- `end_date` string
- `sort_by` string
- `order_by` string
- `status` integer
- `payment_method` integer

## Response `200`

Successful response

- ResponseListBilling — Billing records list response payload.
  - `success` boolean — Indicates whether the request was successful.
  - `message` string — Human-readable response message.
  - `result` object — Paginated response data.
    - `items` BillingInfo[] — List of billing records.
      - `id` string — Billing record ID.
      - `billing_number` string — Billing reference number.
      - `type` integer — Billing record type. 1: Purchase (data/IPs), 2: Wallet top-up
      - `package_id` number, nullable — Associated package ID (if applicable).
      - `account_id` integer — Account ID that owns this billing record.
      - `amount` number — Total billed amount.
      - `number_of_ips` number, nullable — Number of IPs granted (if applicable).
      - `amount_traffic` number, nullable — Traffic amount granted (if applicable).
      - `payment_method` integer — 1: Crypto 2: Card 3: Local Payment 4: Wallet 5: Income
      - `status` integer — Billing status. 0: pending, 1: success, -1: failed
      - `created_at` integer — Billing creation timestamp.
    - `total_items` integer — Total number of items.
    - `total_pages` integer — Total number of pages.

## Other responses

- `400` — Bad request
- `403` — Authentication error

---

[API](https://skmtc.net/9proxy/apis/cd-key.md) · [All operations](https://skmtc.net/9proxy/apis/cd-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/9proxy/cd-key/versions/c159f83789a8/schema)