CustomerOrder

June 8, 2026 ยท View on GitHub

Fields

FieldTypeRequiredDescriptionExample
idstr:heavy_check_mark:The ID of the object.
created_atdate:heavy_check_mark:Creation timestamp of the object.
modified_atdate:heavy_check_mark:Last modification timestamp of the object.
statusmodels.OrderStatus:heavy_check_mark:N/A
paidbool:heavy_check_mark:Whether the order has been paid for.true
subtotal_amountint:heavy_check_mark:Amount in cents, before discounts and taxes.10000
discount_amountint:heavy_check_mark:Discount amount in cents.1000
net_amountint:heavy_check_mark:Amount in cents, after discounts but before taxes.9000
tax_amountint:heavy_check_mark:Sales tax amount in cents.720
total_amountint:heavy_check_mark:Amount in cents, after discounts and taxes.9720
applied_balance_amountint:heavy_check_mark:Customer's balance amount applied to this invoice. Can increase the total amount paid, if the customer has a negative balance, or decrease it, if the customer has a positive balance.Amount in cents.0
due_amountint:heavy_check_mark:Amount in cents that is due for this order.0
refunded_amountint:heavy_check_mark:Amount refunded in cents.0
refunded_tax_amountint:heavy_check_mark:Sales tax refunded in cents.0
currencystr:heavy_check_mark:N/Ausd
billing_reasonmodels.OrderBillingReason:heavy_check_mark:N/A
billing_nameNullable[str]:heavy_check_mark:The name of the customer that should appear on the invoice.
billing_addressNullable[models.Address]:heavy_check_mark:N/A
invoice_numberNullable[str]:heavy_check_mark:The invoice number associated with this order. null while the order is in draft status; assigned at finalize.
is_invoice_generatedbool:heavy_check_mark:Whether an invoice has been generated for this order.
receipt_numberNullable[str]:heavy_check_mark:The receipt number for this order. Set once the order is paid for organizations with receipts enabled. When set, a downloadable receipt PDF can be obtained via the receipt endpoint.
seatsOptionalNullable[int]:heavy_minus_sign:Number of seats purchased (for seat-based one-time orders).
customer_idstr:heavy_check_mark:N/A
product_idNullable[str]:heavy_check_mark:N/A
discount_idNullable[str]:heavy_check_mark:N/A
subscription_idNullable[str]:heavy_check_mark:N/A
checkout_idNullable[str]:heavy_check_mark:N/A
productNullable[models.CustomerOrderProduct]:heavy_check_mark:N/A
subscriptionNullable[models.CustomerOrderSubscription]:heavy_check_mark:N/A
itemsList[models.OrderItemSchema]:heavy_check_mark:Line items composing the order.
descriptionstr:heavy_check_mark:A summary description of the order.Pro Plan
next_payment_attempt_atdate:heavy_minus_sign:When the next payment retry is scheduled
refundable_amountint:heavy_check_mark:Amount in cents that can still be refunded (net, before taxes). Accounts for any applied customer balance and previous refunds.9000
refundable_tax_amountint:heavy_check_mark:Sales tax in cents that would be refunded if the full refundable amount is refunded.720