---
title: "Get a billing record by ID"
method: GET
path: "/billings/{billing-id}"
tags: ["Billing"]
---

# Get a billing record by ID

`GET /billings/{billing-id}`

Retrieves a single billing record by its unique identifier. Returns only the billing record without related account or reference resource data.

## Path parameters

- `billing-id` string, uuid, required

## Response `200`

Successfully retrieved billing record

- 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

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `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)