Create Manual Line Item
Create a manual line item for a billing v1 subscription. Manual line items are ad-hoc charges or credits that flow through the same collection pipeline as auto-generated items. Exactly one of subscriptionId or invoiceId must be provided.
Authorizations
API key authentication
Headers
Optional idempotency key. If provided, duplicate requests with the same key return the previously created item.
255Body
Human-readable label shown on the invoice.
1 - 255ISO 4217 currency code (e.g., USD). Must match the subscription or invoice currency.
3Number of units.
Price per unit as a decimal amount (e.g., 29.99 for $29.99). Can be negative for credits or adjustments.
The subscription ID. Exactly one of subscriptionId or invoiceId must be provided.
The invoice ID to attach this item directly to. Exactly one of subscriptionId or invoiceId must be provided. The invoice must be in ACTIVE or CLOSING state.
^inv_[a-zA-Z0-9]+$Optional longer description shown on the invoice.
1000When to collect this item into an invoice. Defaults to now. Ignored when invoiceId is provided.
Start of the billing period for display purposes. Defaults to now.
End of the billing period for display purposes. Defaults to now.
Optional caller-provided idempotency key. Auto-generated if not provided.
1 - 255Response
Idempotent retry — returns previously created item
The line item ID
The subscription this line item belongs to
The type of line item
fee, metered, manual Whether this item is pending or already on an invoice
pending, invoiced Human-readable label shown on the invoice
ISO 4217 currency code (e.g., USD)
Start of the billing period (inclusive)
End of the billing period (exclusive)
When this line item should be collected into an invoice
Price per unit in invoice currency
When the line item was created
When the line item was last updated
The price ID associated with this line item
The invoice ID if this item has been invoiced
Optional longer description
When metered quantity was last computed
Units sold. Null for metered lines until invoice close
Raw metered usage. Null for fee/manual lines
Payment term for fee items. Null for metered/manual lines
in_advance, in_arrears quantity x unitPrice, before discounts and taxes. Defaults to '0.00' when not yet calculated
Total tax amount for this line item in decimal format. Null until invoice calculation is complete
Final total after discounts and taxes. Defaults to '0.00' when not yet calculated
Real-time estimated metered usage quantity. Only present for type=metered items during an active billing period. Null for fee/manual items or when estimation is unavailable.
Real-time estimated subtotal based on current metered usage. Only present for type=metered items during an active billing period. Null for fee/manual items or when estimation is unavailable.