> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# BillingPlans Resource

The Billing resource provides methods that allow you to manage the billing plans associated with an account.

## Methods supported

| Method                                                                                                                     | Description                                                                                                                   |
| -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| [get](/docs/esign-rest-api/reference/billing/billingplans/get)                                                             | GET `/restapi/v2.1/billing_plans/{billingPlanId}` Gets billing plan details.                                                  |
| [getAccountPlan](/docs/esign-rest-api/reference/billing/billingplans/getaccountplan)                                       | GET `/restapi/v2.1/accounts/{accountId}/billing_plan` Get Account Billing Plan                                                |
| [getCreditCard](/docs/esign-rest-api/reference/billing/billingplans/getcreditcard)                                         | GET `/restapi/v2.1/accounts/{accountId}/billing_plan/credit_card` Get credit card information                                 |
| [getDowngradeRequestBillingInfo](/docs/esign-rest-api/reference/billing/billingplans/getdowngraderequestbillinginfo)       | GET `/restapi/v2.1/accounts/{accountId}/billing_plan/downgrade` Returns downgrade plan information for the specified account. |
| [list](/docs/esign-rest-api/reference/billing/billingplans/list)                                                           | GET `/restapi/v2.1/billing_plans` Gets a list of available billing plans.                                                     |
| [purchaseEnvelopes](/docs/esign-rest-api/reference/billing/billingplans/purchaseenvelopes)                                 | PUT `/restapi/v2.1/accounts/{accountId}/billing_plan/purchased_envelopes` Reserved: Purchase additional envelopes.            |
| [update](/docs/esign-rest-api/reference/billing/billingplans/update)                                                       | PUT `/restapi/v2.1/accounts/{accountId}/billing_plan` Updates an account billing plan.                                        |
| [updateDowngradeAccountBillingPlan](/docs/esign-rest-api/reference/billing/billingplans/updatedowngradeaccountbillingplan) | PUT `/restapi/v2.1/accounts/{accountId}/billing_plan/downgrade` Queues downgrade billing plan request for an account.         |

## BillingPlans properties

| Property                            | Type                             | Description                                                                                                                                                                                                                       |
| ----------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `billingAddress`                    | accountAddress                   | The billing address for the account.                                                                                                                                                                                              |
| `billingAddressIsCreditCardAddress` | string                           | When **true,** the credit card address information is the same as that returned as the billing address. If false, then the billing address is considered a billing contact address, and the credit card address can be different. |
| `billingPlan`                       | accountBillingPlan               | An object that contains details about the billing plan.                                                                                                                                                                           |
| `creditCardInformation`             | creditCardInformation            | A complex type that has information about the credit card used to pay for this account.                                                                                                                                           |
| `directDebitProcessorInformation`   | directDebitProcessorInformation  | Information about the bank that processes direct debits for the payment plan.                                                                                                                                                     |
| `downgradePlanInformation`          | downgradePlanUpdateResponse      |                                                                                                                                                                                                                                   |
| `downgradeRequestInformation`       | downgradeRequestInformation      |                                                                                                                                                                                                                                   |
| `entityInformation`                 | billingEntityInformationResponse |                                                                                                                                                                                                                                   |
| `paymentMethod`                     | string                           | The payment method used for the billing plan. Valid values are:- `NotSupported`
- `CreditCard`
- `PurchaseOrder`
- `Premium`
- `Freemium`
- `FreeTrial`
- `AppStore`
- `DigitalExternal`
- `DirectDebit`                          |
| `paymentProcessorInformation`       | paymentProcessorInformation      | Information about the entity that processes payments for the billing plan.                                                                                                                                                        |
| `referralInformation`               | referralInformation              | Contains information describing discounts and promotions.                                                                                                                                                                         |
| `successorPlans`                    | array                            | A list of billing plans that the current billing plan can be rolled into.                                                                                                                                                         |
| `taxExemptId`                       | string                           |                                                                                                                                                                                                                                   |