# Backend BillingSubscriptionItem object

> Billing is currently in Beta and its APIs are experimental and may undergo breaking changes. To mitigate potential disruptions, we recommend [pinning](https://clerk.com/docs/pinning.md) your SDK and `clerk-js` package versions.

The `BillingSubscriptionItem` object is similar to the [BillingSubscriptionItemResource](https://clerk.com/docs/reference/types/billing-subscription-item-resource.md) object as it holds information about a Subscription Item, as well as methods for managing it. However, the `BillingSubscriptionItem` object is different in that it is used in the [Backend API](https://clerk.com/docs/reference/backend-api/tag/billing/GET/billing/subscription_items){{ target: '_blank' }} and is not directly accessible from the Frontend API.

## Properties

| Name          | Type                                                                                                       | Description                                                                                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id            | string                                                                                                     | The unique identifier for the Subscription Item.                                                                                                               |
| status        | 'active' | 'past\_due' | 'upcoming' | 'canceled' | 'ended' | 'expired' | 'incomplete' | 'abandoned' | The status of the Subscription Item.                                                                                                                           |
| planPeriod    | 'month' | 'annual'                                                                                        | The Plan period for the Subscription Item.                                                                                                                     |
| periodStart   | number                                                                                                     | Unix timestamp (milliseconds) of when the current period starts.                                                                                               |
| periodEnd     | number | null                                                                                             | Unix timestamp (milliseconds) of when the current period ends.                                                                                                 |
| nextPayment   | null | { amount: number; date: number; }                                                                 | The next payment information. If present, contains the amount of the next payment and the Unix timestamp (milliseconds) of when the next payment is scheduled. |
| amount        | BillingMoneyAmount | undefined                                                                            | The current amount for the Subscription Item.                                                                                                                  |
| plan          | BillingPlan | null                                                                                        | The Plan associated with this Subscription Item.                                                                                                               |
| planId        | string | null                                                                                             | The Plan ID.                                                                                                                                                   |
| createdAt     | number                                                                                                     | Unix timestamp (milliseconds) of when the Subscription Item was created.                                                                                       |
| updatedAt     | number                                                                                                     | Unix timestamp (milliseconds) of when the Subscription Item was last updated.                                                                                  |
| canceledAt    | number | null                                                                                             | Unix timestamp (milliseconds) of when the Subscription Item was canceled.                                                                                      |
| pastDueAt     | number | null                                                                                             | Unix timestamp (milliseconds) of when the Subscription Item became past due.                                                                                   |
| endedAt       | number | null                                                                                             | Unix timestamp (milliseconds) of when the Subscription Item ended.                                                                                             |
| payerId       | string | undefined                                                                                        | The payer ID.                                                                                                                                                  |
| isFreeTrial?  | boolean                                                                                                    | Whether this Subscription Item is currently in a free trial period.                                                                                            |
| lifetimePaid? | null | BillingMoneyAmount                                                                                 | The lifetime amount paid for this Subscription Item.                                                                                                           |

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)