The invoice object

The invoice object represents a single billing cycle’s payment record within a subscription.

Example invoice object

JSON

{
  "object": "invoice",
  "id": "019a5ebd-5284-7d0e-8251-76199516d051",
  "subscription_id": "cfc58230-fad2-44a2-a355-ca220f528466",
  "status": "draft",
  "amount": 899,
  "currency": "EUR",
  "period_start_date": "2025-11-07",
  "period_end_date": "2025-12-07",
  "due_date": "2025-11-07",
  "store_id": "6602a38a-2cfe-43b2-9dd2-cbb9eb8a6d1f",
  "created_at": "2025-11-07T14:34:17.092922Z"
}

Attributes

name	type	description
object	string (required)	Always set to invoice.
id	string	Unique identifier of the invoice.
subscription_id	string (required)	Unique identifier of the Subscription associated with the invoice.
status	enum: "draft", "open", "paid", "uncollectible", "void" (required)	Current status of the invoice.
amount	number (required)	Total amount due, in minor currency units (e.g., cents).
currency	string (required)	Three-letter ISO 4217 currency code, uppercase. Must be a supported currency .
period_start_date	date (required)	Inclusive start date of the billing period this invoice covers.
period_end_date	date (required)	Exclusive end date; i.e., the first calendar day after the billing period ends (the day is not part of the billed period).
due_date	date (required)	Date by which payment is due.
store_id	string (required)	Identifier of the store associated with the invoice.
created_at	timestamp (required)	Date and time when the invoice was created (ISO 8601 format).