---
title: "List order usage meters"
method: GET
path: "/meter/{customer_id}/get/{order_id}"
tags: ["Usage"]
---

# List order usage meters

`GET /meter/{customer_id}/get/{order_id}`

Returns usage billing meters configured on the order's package, including current unbilled usage, remaining free allowance, billable quantity, and threshold warnings. The authenticated API key must own the order.

## Path parameters

- `customer_id` integer, required
- `order_id` integer, required

## Response `200`

Usage meters returned

- UsageMetersResponse
  - `success` true
  - `data` UsageMeter[]
    - `id` integer — Package usage metric ID.
    - `name` string — Usage metric name. Use this value as `name` when recording usage.
    - `unit_label` string — Display label for the usage unit.
    - `included_allowance` number — Included free quantity for this metric.
    - `unit_price` string — Overage unit price formatted with six decimal places.
    - `usage` UsageStatus
      - `used` number — Total unbilled usage recorded for this metric.
      - `remaining_free` number — Remaining included allowance before overage billing applies.
      - `remaining_free_percent` number, nullable — Percentage of included allowance remaining. Null when the metric has no included allowance.
      - `overage_qty` number — Quantity above the included allowance.
      - `billable_qty` number — Quantity currently billable in arrears.
      - `current_unbilled_amount` string — Current unbilled amount for this metric, formatted with four decimal places.
      - `threshold` UsageThreshold
        - `level` string
        - `threshold` 10 | 25
        - `message` string

## Other responses

- `401` — Missing or invalid API key
- `403` — Authenticated key does not have permission for this endpoint
- `404` — Order or package not found
- `422` — Validation error

---

[API](https://skmtc.net/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.net/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)