# Subscription.renewed

URL: /business/events/Subscription.renewed · Id: `event:Subscription.renewed`

> Emitted each time a Subscription is renewed.

[Subscription.renew](/business/nouns/subscription/renew) emits `Subscription.renewed` when it completes on a [Subscription](/business/nouns/subscription).

| Property | Value |
| --- | --- |
| Emitted by | [Subscription.renew](/business/nouns/subscription/renew) |
| Noun | [Subscription](/business/nouns/subscription) |
| Moves | [Subscription](/business/nouns/subscription) `trialing` to `active` |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Subscription.renew](/business/nouns/subscription/renew) returns, and `previous` holds the state it left.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Subscription.renewed`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.invoice` | [Invoice](/business/nouns/invoice) | Yes | The Invoice for the new period. |
| `data.subscription` | [Subscription](/business/nouns/subscription) | Yes | The Subscription in its new period. |
| `data.subscription.status` | `string` | Yes | One of `active`, `trialing`, `pastDue`, `paused`, `incomplete`, or `canceled`. |
| `data.subscription.renewsAt` | `datetime` | No | When it next renews. |
| `data.subscription.quantity` | `integer` | No | How many units of the Offer’s Price it holds, such as 12 members; 1 by default. |
| `data.subscription.trialEndsAt` | `datetime` | No | When a trial ends and the first paid period starts. |
| `data.subscription.termEndsAt` | `datetime` | No | When a committed term ends; the Renewal and the renewal notice read it. |
| `data.previous.status` | `string` | Yes | The `status` before this Event: `trialing`. |

### Example
```json
{
  "$id": "https://api.sb/routewise.dev/events/event_1",
  "$type": "Event",
  "name": "Subscription.renewed",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "invoice": {
      "$id": "https://api.sb/routewise.dev/invoices/invoice_1",
      "$type": "Invoice",
      "total": {
        "amount": 25,
        "currency": "USD"
      },
      "due": "2026-10-22"
    },
    "subscription": {
      "$id": "https://api.sb/routewise.dev/subscriptions/subscription_1",
      "$type": "Subscription",
      "status": "active",
      "renewsAt": "2026-10-22T12:00:00Z",
      "quantity": 1,
      "trialEndsAt": "2026-10-22T12:00:00Z",
      "termEndsAt": "2026-10-22T12:00:00Z"
    },
    "previous": {
      "status": "trialing"
    }
  },
  "seq": 1
}
```