# RecurringBillingSubscriptionPlan

Object · GraphQL API

A recurring billing subscription plan template that subscriptions can be based upon.

## Fields

- `id` (`ID!`) — non-null: The plan identifier.
- `legacyId` (`ID!`) — non-null: The legacy plan identifier.
- `name` (`String!`) — non-null: The name of the plan.
- `description` (`String`): A description of the plan.
- `price` (`MonetaryAmount!`) — non-null: The base price and currency for this plan.
- `billingFrequency` (`Int!`) — non-null: The billing interval of the plan in months.
- `billingDayOfMonth` (`Int`): The day of the month the subscription is billed.
- `numberOfBillingCycles` (`Int`): The number of times the billing cycle will be executed. A value of 0 indicates the plan never expires.
- `trial` (`RecurringBillingSubscriptionTrial`): Trial period settings for this plan.
- `addOns` (`[RecurringBillingSubscriptionPlanAddOn!]`): The collection of add-ons associated with this plan.
- `discounts` (`[RecurringBillingSubscriptionPlanDiscount!]`): The collection of discounts associated with this plan.
- `createdAt` (`Timestamp!`) — non-null: The date/time the plan was created.
- `updatedAt` (`Timestamp!`) — non-null: The date/time the plan was last updated.

## Used by

- [Node](/braintree/graphql/reference/types/node) — Interface; Possible type
- [RecurringBillingSubscriptionPlanPayload](/braintree/graphql/reference/types/recurring-billing-subscription-plan-payload) — Object; plan
- [RecurringBillingSubscriptionPlansPayload](/braintree/graphql/reference/types/recurring-billing-subscription-plans-payload) — Object; plans

## GraphQL definition

```graphql
type RecurringBillingSubscriptionPlan implements Node {
  id: ID!
  legacyId: ID!
  name: String!
  description: String
  price: MonetaryAmount!
  billingFrequency: Int!
  billingDayOfMonth: Int
  numberOfBillingCycles: Int
  trial: RecurringBillingSubscriptionTrial
  addOns: [RecurringBillingSubscriptionPlanAddOn!]
  discounts: [RecurringBillingSubscriptionPlanDiscount!]
  createdAt: Timestamp!
  updatedAt: Timestamp!
}
```

---

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