Skip to main content
Invoice resource properties and example object, including optional billing address details. This resource represents an invoice. An invoice can be created one-off or as part of a recurring subscription. An invoice consists of line items which can be connected to Products & Prices or be one-off items. All amounts are in the minor unit of the currency. For example, 1000 represents $10.00 for USD, £10.00 for GBP, or ¥1000 for JPY.

​
Properties

id string The unique identifier for this item. createdAt string The date this item was created in RFC3339 format. updatedAt string The date this item was updated in RFC3339 format. object string The object type of this resource. collectionMethod string How the payment for this invoice is collected. It will be sendInvoice when an invoice is sent to a recipient for payment. It will be chargeAutomatically if the invoice is charged at the time of creation. currency string The 3 letter currency code representing the settlement currency for this invoice. dueDate string The date when this invoice is due in RFC3339 format. This only applies when the collectionMethod is sendInvoice. memo string The memo added to the invoice. number string A unique number generated for this invoice. Invoice numbers are commonly used for accounting purposes. recipientId string Deprecated in favor of clientId and companyId. clientId string The ID of the client this invoice is assigned to. companyId string The ID of the company this invoice is assigned to. When the invoice is assigned to an individual this represents which of the client’s companies this invoice is associated with. address object | null Optional billing address associated with the invoice.
  • country string The two-letter country code for the address.
  • region string The state, province, or region for the address.
  • postalCode string The postal or ZIP code for the address.
  • addressLine1 string The first line of the street address.
  • city string The city for the address.
  • fullAddress string The formatted mailing address, including line breaks.
sentDate string The date this invoice was sent to a client in RFC3339 format. paymentSuccessDate string The date this invoice was paid in RFC3339 format. This property is only set when there is a successful payment associated with an invoice. When an invoice is marked as manually paid, there is no associated payment so this property is ignored. status string The status of the invoice. One of draft, open, paid, void. taxPercentage number The percentage of tax set on this invoice. taxAmount number The amount of tax on this invoice based on the percentage amount and lineItems. total number The total amount of this invoice to be paid. This is the total of the lineItems and taxAmount. lineItems array(lineItems)
  • amount number The amount for a single unit of this line item. The total amount due for this line item is the product of this amount and quantity
  • description string The description of the product. This is not relevant for one-off line items.
  • quantity number How many units of this item are being invoiced
  • priceId string The ID of the price that this line item is based off. The amount property is set based on the amount of specified on the Price. This is not relevant for one-off line items.
  • productId string The ID of the product that this line item is based off. The description property is set based on the description of set on the product. This is not relevant for one-off line items.
paymentMethodPreferences Array(object) Array of payment method configurations that specify which payment methods are allowed and how transaction fees are handled for each method. Each object in the array contains:
  • type string Payment method type. Values are creditCard or bankAccount
  • feePaidByClient boolean When true, the transaction fee is paid by the client. When false, the fee is absorbed by the business.
fileUrl: string Link to download invoice PDF receiptNumber: string Invoice receipt number if invoice is paid. receiptUrl: string Link to download invoice receipt PDF, if invoice is paid. billingReason: string | null Indicates the reason why the invoice was created. Values can be
  • manual
  • subscriptionCreate
  • subscriptionCycle
  • subscriptionUpdate
    • For subscription invoices, this field will have non-empty value for invoices created after Jan. 29th 2025.

Example Invoice Object