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

# Subscription object

A subscription bills your customer on a recurring schedule. The subscription groups billable items, tracks the billing cycle, and generates an invoice for each period. The subscription reflects whether billing is active, in a trial, or canceled.

```json theme={null}
{
  "id": "sub_456789abcdef",
  "object": "subscription",
  "billing_cycle_anchor": "2025-08-01T00:00:00Z",
  "collection_method": "charge_automatically",
  "created_at": "2025-08-01T12:00:00Z",
  "customer": "cus_01234567",
  "items": [
    {
      "id": "si_89abcdef0123",
      "object": "subscription_item",
      "price": {
        "currency": "CLP",
        "product": {
          "name": "Pro Plan"
        },
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 15000
      },
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "payment_method": null,
  "status": "trialing",
  "trial_end": "2025-10-01T00:00:00Z"
}
```

| Attribute              | Type           | Description                                                                                                                                                                                                                          |
| ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                   | string         | Unique identifier for the subscription.                                                                                                                                                                                              |
| `object`               | string         | Type of the object. Always `"subscription"`.                                                                                                                                                                                         |
| `billing_cycle_anchor` | string         | Reference point used to align future invoices. ISO 8601 datetime in UTC.                                                                                                                                                             |
| `collection_method`    | string         | One of `"charge_automatically"` or `"send_invoice"`. With `"charge_automatically"`, Fintoc collects each invoice using the attached payment method. With `"send_invoice"`, Fintoc emails your customer to pay each invoice manually. |
| `created_at`           | string         | ISO 8601 datetime in UTC when the subscription was created.                                                                                                                                                                          |
| `customer`             | string         | ID of the customer this subscription bills.                                                                                                                                                                                          |
| `items`                | array          | List of subscription item objects. See the Subscription Item attributes below.                                                                                                                                                       |
| `metadata`             | object         | Set of [key-value](/reference/fintoc-api/metadata) pairs you can attach to the subscription, useful for storing additional structured information.                                                                                   |
| `mode`                 | string         | One of `"live"` or `"test"`.                                                                                                                                                                                                         |
| `payment_method`       | string \| null | ID of the payment method used to charge this subscription automatically. `null` if no payment method is attached.                                                                                                                    |
| `status`               | string         | One of `"active"`, `"trialing"`, or `"canceled"`. A canceled subscription no longer creates invoices.                                                                                                                                |
| `trial_end`            | string \| null | ISO 8601 datetime in UTC marking the end of the trial period. `null` if the subscription has no trial.                                                                                                                               |

## Subscription Item

| Attribute                        | Type    | Description                                                                                                 |
| -------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| `id`                             | string  | Unique identifier for the subscription item.                                                                |
| `object`                         | string  | Type of the object. Always `"subscription_item"`.                                                           |
| `price`                          | object  | Price details for this item.                                                                                |
| `price.currency`                 | string  | Three-letter ISO 4217 currency code. Fintoc supports CLP only.                                              |
| `price.product`                  | object  | Product details for this item.                                                                              |
| `price.product.name`             | string  | Name of the product.                                                                                        |
| `price.recurring`                | object  | Billing recurrence configuration.                                                                           |
| `price.recurring.interval`       | string  | Billing frequency. Fintoc supports `month` only.                                                            |
| `price.recurring.interval_count` | integer | Number of intervals between billings.                                                                       |
| `price.unit_amount`              | integer | Amount charged per unit, in the smallest currency unit. CLP has no minor unit, so `15000` means 15,000 CLP. |
| `quantity`                       | integer | Number of units billed.                                                                                     |

<br />