{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/recurly/json-schema/recurly-usage-create-schema.json",
  "title": "UsageCreate",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/recurly-usage-api-openapi.yml#/components/schemas/UsageCreate",
  "type": "object",
  "properties": {
    "merchant_tag": {
      "type": "string",
      "description": "Custom field for recording the id in your own system associated with the usage, so you can provide auditable usage displays to your customers using a GET on this endpoint."
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "The amount of usage. Can be positive, negative, or 0. If the Decimal Quantity feature is enabled, this value will be rounded to nine decimal places.  Otherwise, all digits after the decimal will be stripped. If the usage-based add-on is billed with a percentage, your usage should be a monetary amount formatted in cents (e.g., $5.00 is \"500\")."
    },
    "recording_timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "When the usage was recorded in your system."
    },
    "usage_timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "When the usage actually happened. This will define the line item dates this usage is billed under and is important for revenue recognition."
    }
  }
}