# RecurringBillingSubscriptionStatusEvent

Object · GraphQL API

Represents a status change event in a subscription's lifecycle.

## Fields

- `status` (`RecurringBillingSubscriptionStatus!`) — non-null: The subscription status.
- `balance` (`Amount!`) — non-null: The balance of the subscription.
- `price` (`Amount!`) — non-null: The price of the subscription.
- `subscriptionSource` (`RecurringBillingSubscriptionSource`): The source that triggered the subscription status change.
- `timestamp` (`Timestamp!`) — non-null: The date and time when the status change occurred.
- `planId` (`ID!`) — non-null: The plan ID associated with the subscription at the time of the status change.
- `currencyIsoCode` (`CurrencyCodeAlpha!`) — non-null: The currency code at the time of the status change.

## Used by

- [RecurringBillingSubscription](/braintree/graphql/reference/types/recurring-billing-subscription) — Object; statusHistory

## GraphQL definition

```graphql
type RecurringBillingSubscriptionStatusEvent {
  status: RecurringBillingSubscriptionStatus!
  balance: Amount!
  price: Amount!
  subscriptionSource: RecurringBillingSubscriptionSource
  timestamp: Timestamp!
  planId: ID!
  currencyIsoCode: CurrencyCodeAlpha!
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)