---
title: "Get list of billings"
method: GET
path: "/billings"
tags: ["Billing"]
---

# Get list of billings

`GET /billings`

Retrieve a list of the customer's billings.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of billings.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` BillingManagerBilling[]
    - `id` string, uuid — The unique identifier of the billing.
    - `customer_id` string, uuid — The customer's unique identifier. Returned from the `GET /customers` response.
    - `account_id` string, uuid — The billing account ID. Returned from the `GET /billing_accounts/{id}` response.
    - `transaction_type` 'usage' | 'top_up' | 'adjustment' | 'refund' — The nature of the ledger entry.
    - `status` 'progressing' | 'end' | 'pending' | 'finished' — Status of the billing.
    - `reference_type` '' | 'call' | 'call_extension' | 'sms' | 'email' | 'number' | 'number_renew' | 'credit_free_tier' | 'monthly_allowance' | 'credit_adjustment' | 'token_adjustment' | 'speaking' | 'recording' — The type of reference associated with this billing.
    - `reference_id` string, uuid — The unique identifier of the referenced resource. The actual resource type is determined by reference_type. Returned from the corresponding resource endpoint.
    - `cost_type` '' | 'call_pstn_outgoing' | 'call_pstn_incoming' | 'call_vn' | 'call_extension' | 'call_direct_ext' | 'sms' | 'email' | 'number' | 'number_renew' | 'tts' | 'recording' — The classification of the billing cost.
    - `usage_duration` integer — The actual usage duration in seconds.
    - `billable_units` integer — The number of billable units (e.g. minutes, rounded up).
    - `rate_token_per_unit` integer — The token rate per billable unit.
    - `rate_credit_per_unit` integer — The credit rate per billable unit in micros.
    - `amount_token` integer — The token delta for this transaction (negative for usage, positive for top-up).
    - `amount_credit` integer — The credit delta for this transaction in micros (negative for usage, positive for top-up).
    - `balance_token_snapshot` integer — The token balance after this transaction.
    - `balance_credit_snapshot` integer — The credit balance after this transaction in micros.
    - `idempotency_key` string, uuid — A unique key to prevent duplicate transactions.
    - `tm_billing_start` string, date-time — The start timestamp of the billing period.
    - `tm_billing_end` string, date-time — The end timestamp of the billing period.
    - `tm_create` string, date-time — The creation timestamp.
    - `tm_update` string, date-time — The last update timestamp.
    - `tm_delete` string, date-time — The deletion timestamp, if applicable.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)