This reference documents every field on a billable item record, including the trigger-specific fields that appear when `bi_billing_type` is set to `trigger`.
Standard Fields (All Billing Types)
Display name shown on invoices and in the UI
Detailed description of the product or service
Base price per unit. For trigger items, this is the default charge amount
Three-letter currency code
Default: USD
Whether tax applies to this item
Default:
Whether bi_unit_price includes tax
Default:
virtual or physical. Trigger items are always virtual
Default: virtual
one-off, recurring, or trigger. Determines which additional fields are available
Default: one-off
all, credit-card, invoice, or trigger-api
Default: all
Whether the item is active. Inactive items cannot be used in new invoices or enrollments
Default: 1
Trigger-Specific Fields (bi_billing_type = trigger only)
fixed, variable, event, or threshold. Determines how amount and condition interact
off_session (charge immediately) or client_confirm (send invoice with Pay Now)
Default: off_session
lte (<=), gte (>=), or eq (=). Required for fixed, variable, and threshold modes
The Y value in the condition check. Required for fixed, variable, and threshold modes
Hard minimum for threshold, enforced by platform. Cannot exceed bi_trigger_threshold
If true, fire endpoint accepts override_amount. Required to be true for variable and event modes
Default:
Upper limit on override_amount. Null means platform default ($500)
Human-readable condition description. Auto-generated but editable. Example: When wallet balance <= $15, charge $200
