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

# Subscription States

> Implemented subscription statuses and transitions.

# Subscription States

## In a nutshell

Subscription status tells you whether a subscription is billable, paused, or ended.

## Statuses

| Status      | Meaning                                                                                                        |
| ----------- | -------------------------------------------------------------------------------------------------------------- |
| `active`    | Subscription is active and eligible for billing. Trial subscriptions also use `active` with trial date fields. |
| `paused`    | Billing is paused, usually because payment failed or the payment source could not be used.                     |
| `canceled`  | Subscription has been canceled.                                                                                |
| `expired`   | Subscription has expired.                                                                                      |
| `attention` | Subscription needs merchant or customer action.                                                                |

## Common transition

```txt theme={null}
active -> paused
```

A failed invoice payment pauses the subscription.

## Trial behavior

Trials are represented with `trialStartDate` and `trialEndDate`. There is no separate public `trialing` status in the current API shape.