Usage

Record usage event

Changed on Aug 22, 2026

Records bill-in-arrears usage for a configured package usage metric on a customer order. The authenticated API key must own the order, and name must match a usage metric configured on the order's package.

post/meter-event

Request

Base URL
https://demo.onlinebillingform.com/api/v2
Auth
HTTP bearer
TypeScript
https://skmtc.dev/b-cdn/apis/billingserv-api-v2/docs/meter-event/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

customer_idinteger required

Customer ID that owns the order.

order_idinteger required

Order ID to record usage against.

namestring required

Usage metric name configured on the order package.

qtynumber required

Usage quantity to add. Must be at least 1.

Response

Usage event recorded

successtrue

Example response

{
  "data": {
    "usage": {
      "threshold": {
        "level": "warning",
        "message": "Free usage is below 10%."
      }
    },
    "meter": {
      "usage": {
        "threshold": {
          "level": "warning",
          "message": "Free usage is below 10%."
        }
      }
    }
  }
}

Changes

Aug 22, 20266b9208b64456 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history