---
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}`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/meter/{customer_id}/get/{order_id}`
- Auth: HTTP bearer

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

## Changes

- **2026-08-22** `6b9208b64456`: 8 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `422` status
  - …4 more

[Operation history](https://skmtc.dev/billingserv/apis/billingserv-api-v2/changes/meter/:customer_id/get/:order_id/get.md)

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)