> ## Documentation Index
> Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscription Templates

> A reusable configuration for creating subscriptions with predefined line items, tax settings, and billing intervals.

This resource represents a subscription template. A subscription template provides a reusable configuration for creating subscriptions with predefined line items, tax settings, and billing intervals.

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 subscription template.

**object** `string`\
The object type of this resource.

**createdAt** `string`\
The date this template was created in RFC3339 format.

**updatedAt** `string`\
The date this template was last updated in RFC3339 format.

**name** `string`\
The name of the subscription template.

**memo** `string`\
An arbitrary string attached to the template, often useful for displaying to users.

**taxPercentage** `number`\
The percentage of tax to be applied to subscriptions created from this template.

**currency** `string`\
The 3 letter currency code representing the settlement currency for subscriptions created from this template.

**interval** `string`\
The billing frequency for subscriptions created from this template. Only required if any of the line items doesn't have a recurring price. When line items include a recurring price, the interval is automatically determined from that price. One of:

* `day` - Daily billing
* `week` - Weekly billing
* `month` - Monthly billing
* `quarterly` - Quarterly billing
* `yearly` - Yearly billing

**intervalCount** `integer`\
The number of intervals between subscription billings. For example, `interval=month` and `intervalCount=3` bills every 3 months. Used in conjunction with the `interval` field to determine billing frequency

**lineItems** `array(object)`\
Array of line items to be included in subscriptions created from this template:

* **amount** `integer`\
  Amount in cents for one unit. Required if priceId not provided
* **description** `string`\
  Description of the line item. Optional for items with priceId where product name is used
* **quantity** `number`\
  Quantity of the item (can be decimal)
* **priceId** `string`\
  ID of the price object. Required if amount not provided
* **productId** `string`\
  ID of the associated product object

**Note:** When a subscription is created using a template, the template's configuration (lineItems, memo, taxPercentage, currency, and interval) will be automatically applied to the new subscription.

```json Example Subscription Template Object theme={null}
{
    "id": "9e1e238f-25e5-4aff-b5f3-6793f8f2703f",
    "object": "subscriptionTemplate",
    "createdAt": "2024-06-24T18:22:31.123456Z",
    "updatedAt": "2024-06-24T18:22:31.123456Z",
    "name": "Enterprise Package",
    "memo": "Annual enterprise subscription package",
    "taxPercentage": 8.5,
    "currency": "usd",
    "interval": "year",
    "intervalCount": 1,
    "lineItems": [
        {
            "amount": 50000,
            "description": "Base License",
            "quantity": 10
        },
        {
            "amount": 25000,
            "description": "Premium Support",
            "priceId": "81108543-bc52-4202-83de-71ad52a74df9",
            "productId": "d0000000-d7a5-473d-a75b-9821a8f4e191",
            "quantity": 1
        }
    ]
}
```