# RecurringBillingSubscriptionTimeline

Object · GraphQL API

Timeline information for a subscription, including billing dates and payment status.

## Fields

- `firstBillingDate` (`Date!`) — non-null: The date when the subscription first started billing. For pending subscriptions with a future start date, this will be a future date.
- `nextBillingDate` (`Date!`) — non-null: The date when the system will attempt to bill the subscription again. For pending subscriptions that have not yet started, this equals firstBillingDate. This date adjusts automatically with each billing attempt. For past due subscriptions with automatic retry enabled, this date will advance based on your configured retry settings.
- `billingPeriodStartDate` (`Date`): The start date for the current billing period, regardless of subscription status. Automatic retries on past due subscriptions do not change the start and end dates of the current billing period.
- `billingPeriodEndDate` (`Date`): The end date for the current billing period, regardless of subscription status. Automatic retries on past due subscriptions do not change the start and end dates of the current billing period.
- `paidThroughDate` (`Date`): The date through which the subscription has been paid. It is the billingPeriodEndDate at the time of the last successful transaction. If the subscription is pending (has a future start date), this field is null.
- `createdAt` (`Timestamp`): The date and time when the subscription was created.
- `updatedAt` (`Timestamp`): The date and time when the subscription was last updated.

## Used by

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

## GraphQL definition

```graphql
type RecurringBillingSubscriptionTimeline {
  firstBillingDate: Date!
  nextBillingDate: Date!
  billingPeriodStartDate: Date
  billingPeriodEndDate: Date
  paidThroughDate: Date
  createdAt: Timestamp
  updatedAt: Timestamp
}
```

---

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