Order

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
metadataDict[str, models.MetadataOutputType]:heavy_check_mark:N/A
custom_field_dataDict[str, Nullable[models.OrderCustomFieldData]]:heavy_minus_sign:Key-value object storing custom field values.
platform_fee_amountint:heavy_check_mark:Platform fee amount in cents.500
platform_fee_currencyNullable[str]:heavy_check_mark:Currency of the platform fee.usd
customermodels.OrderCustomer:heavy_check_mark:N/A
productNullable[models.OrderProduct]:heavy_check_mark:N/A
discountNullable[models.OrderDiscount]:heavy_check_mark:N/A
subscriptionNullable[models.OrderSubscription]: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
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