Usage

Record usage event

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

Changed in 1 of the 6 revisions of this API.8

Aug 22, 20266b9208b644568See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added

Full history