> 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

# Get billing plan details

GET https://demo.docusign.net/restapi/v2.1/billing_plans/{billingPlanId}

Retrieves the billing plan details for the specified billing plan ID.

Reference: https://developers.docusign.com/docs/esign-rest-api/reference/billing/billingplans/get

## Authentication

- `Authorization` header (required) (prefixed with ` Bearer  `) — OAuth 2.0 access token (JWT or auth-code grant). Sent as `Authorization: Bearer <token>` on every request except `GET /v2.1` and `GET /service_information`, which are public discovery endpoints.

## Servers

- `https://demo.docusign.net/restapi` (Demo, default)
- `https://www.docusign.net/restapi` (Production)

## Request

### Path parameters

- `billingPlanId` (string, required) — The ID of the billing plan being accessed.

## Response

### 200

Successful response.

- `billingPlan` (billingPlan, optional) — Contains information about a billing plan.
- `successorPlans` (list of billingPlan, optional) — A list of billing plans that the current billing plan can be rolled into.

## Errors

### 400 Bad Request Error

Error encountered.

- `errorCode` (string, optional) — The code associated with the error condition.
- `message` (string, optional) — A brief message describing the error condition.

## Types

### billingPlan

Contains information about a billing plan.

- `appStoreProducts` (list of appStoreProduct, optional) — Reserved for Docusign.
- `currencyPlanPrices` (list of currencyPlanPrice, optional) — Contains the currencyCode and currencySymbol for the alternate currency values for envelopeFee, fixedFee, and seatFee that are configured for this plan feature set.
- `enableSupport` (string, optional) — When **true,** customer support is provided as part of the account plan.
- `includedSeats` (string, optional) — The number of seats (users) included in the plan.
- `otherDiscountPercent` (string, optional) — Any other percentage discount for the plan. Example: `"0.00"`
- `paymentCycle` (string, optional) — The payment cycle associated with the plan. Valid values: Monthly or Annually.
- `paymentMethod` (string, optional) — The payment method used for the billing plan. Valid values are: - `NotSupported` - `CreditCard` - `PurchaseOrder` - `Premium` - `Freemium` - `FreeTrial` - `AppStore` - `DigitalExternal` - `DirectDebit`
- `perSeatPrice` (string, optional) — The per seat price for the plan.
- `planClassification` (string, optional) — Identifies the type of plan. Examples include Business, Corporate, Enterprise, Free.
- `planFeatureSets` (list of featureSet, optional) — Reserved for Docusign.
- `planId` (string, optional) — Docusign's ID for the account plan.
- `planName` (string, optional) — The name of the Billing Plan.
- `seatDiscounts` (list of seatDiscount, optional) — A complex type that returns information about any seat discounts. It contains the information `BeginSeatCount`, `EndSeatCount` and `SeatDiscountPercent`.
- `supportIncidentFee` (string, optional) — The support incident fee charged for each support incident. Example: `"$0.00"`
- `supportPlanFee` (string, optional) — The support plan fee charged for this plan. Example: `"$0.00"`

### appStoreProduct

Contains information about an APP store product.

- `marketPlace` (string, optional)
- `productId` (string, optional) — The Product ID from the AppStore.

### currencyPlanPrice

- `currencyCode` (string, optional) — Specifies the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code for the account.
- `currencySymbol` (string, optional) — Specifies the currency symbol. Valid values: * `AED` "د.إ" * `AFN` "؋" * `ALL` "L" * `AMD` "֏" * `ANG` "ƒ" * `AOA` "Kz" * `ARS` "\$" * `AUD` "\$" * `AWG` "ƒ" * `AZN` "₼" * `BAM` "KM" * `BBD` "\$" * `BDT` "৳" * `BGN` "лв" * `BHD` ".د.ب" * `BIF` "FBu" * `BMD` "\$" * `BND` "\$" * `BOB` "\$b" * `BOV` "BOV" * `BRL` "R\$" * `BSD` "\$" * `BTN` "Nu." * `BWP` "P" * `BYN` "Br" * `BYR` "Br" * `BZD` "BZ\$" * `CAD` "\$" * `CDF` "FC" * `CHE` "CHE" * `CHF` "CHF" * `CHW` "CHW" * `CLF` "CLF" * `CLP` "\$" * `CNY` "¥" * `COP` "\$" * `COU` "COU" * `CRC` "₡" * `CUC` "\$" * `CUP` "₱" * `CVE` "\$" * `CZK` "Kč" * `DJF` "Fdj" * `DKK` "kr" * `DOP` "RD\$" * `DZD` "دج" * `EGP` "£" * `ERN` "Nfk" * `ETB` "Br" * `EUR` "€" * `FJD` "\$" * `FKP` "£" * `GBP` "£" * `GEL` "₾" * `GHS` "GH₵" * `GIP` "£" * `GMD` "D" * `GNF` "FG" * `GTQ` "Q" * `GYD` "\$" * `HKD` "\$" * `HNL` "L" * `HRK` "kn" * `HTG` "G" * `HUF` "Ft" * `IDR` "Rp" * `ILS` "₪" * `INR` "₹" * `IQD` "ع.د" * `IRR` "﷼" * `ISK` "kr" * `JMD` "J\$" * `JOD` "JD" * `JPY` "¥" * `KES` "KSh" * `KGS` "лв" * `KHR` "៛" * `KMF` "CF" * `KPW` "₩" * `KRW` "₩" * `KWD` "KD" * `KYD` "\$" * `KZT` "₸" * `LAK` "₭" * `LBP` "£" * `LKR` "₨" * `LRD` "\$" * `LSL` "M" * `LYD` "LD" * `MAD` "MAD" * `MDL` "lei" * `MGA` "Ar" * `MKD` "ден" * `MMK` "K" * `MNT` "₮" * `MOP` "MOP\$" * `MRO` "UM" * `MUR` "₨" * `MVR` "Rf" * `MWK` "MK" * `MXN` "\$" * `MXV` "MXV" * `MYR` "RM" * `MZN` "MT" * `NAD` "\$" * `NGN` "₦" * `NIO` "C\$" * `NOK` "kr" * `NPR` "₨" * `NZD` "\$" * `OMR` "﷼" * `PAB` "B/." * `PEN` "S/." * `PGK` "K" * `PHP` "₱" * `PKR` "₨" * `PLN` "zł" * `PYG` "Gs" * `QAR` "﷼" * `RON` "lei" * `RSD` "Дин." * `RUB` "₽" * `RWF` "R₣" * `SAR` "﷼" * `SBD` "\$" * `SCR` "₨" * `SDG` "ج.س." * `SEK` "kr" * `SGD` "S\$" * `SHP` "£" * `SLL` "Le" * `SOS` "S" * `SRD` "\$" * `SSP` "£" * `STD` "Db" * `SVC` "\$" * `SYP` "£" * `SZL` "E" * `THB` "฿" * `TJS` "SM" * `TMT` "T" * `TND` "د.ت" * `TOP` "T\$" * `TRY` "₺" * `TTD` "TT\$" * `TWD` "NT\$" * `TZS` "TSh" * `UAH` "₴" * `UGX` "USh" * `USD` "\$" * `USN` "\$" * `UYI` "UYI" * `UYU` "\$U" * `UZS` "лв" * `VEF` "Bs" * `VND` "₫" * `VUV` "VT" * `WST` "WS\$" * `XAF` "FCFA" * `XAG` "XAG" Silver * `XAU` "XAU" Gold * `XBA` "XBA" Bond Markets Units European Composite Unit (EURCO) * `XBB` "XBB" European Monetary Unit (E.M.U.-6) * `XBC` "XBC" European Unit of Account 9(E.U.A.-9) * `XBD` "XBD" European Unit of Account 17(E.U.A.-17) * `XCD` "\$" * `XDR` "XDR" } `<br /> // Special Drawing Rights (SDRs)` units of account for IMF * `XOF` "CFA" * `XPD` "XPD" Palladium * `XPF` "₣" * `XPT` "XPT" Platinum * `XSU` "Sucre" * `XTS` "XTS" Reserved for testing purposes * `XUA` "XUA" * `XXX` "XXX" Denotes transaction involving no currency * `YER` "﷼" * `ZAR` "R" * `ZMW` "ZK" * `ZWL` "\$"
- `perSeatPrice` (string, optional) — The per-seat price associated with the plan. Example: `"456.0000"`
- `supportedCardTypes` (creditCardTypes, optional)
- `supportIncidentFee` (string, optional) — The support incident fee charged for each support incident. Example: `"$0.00"`
- `supportPlanFee` (string, optional) — The support plan fee charged for this plan. Example: `"$0.00"`

### featureSet

This object provides details about a feature set, or add-on product that is associated with an account. It is reserved for DocuSign internal use only.

- `currencyFeatureSetPrices` (list of currencyFeatureSetPrice, optional) — Reserved for Docusign.
- `envelopeFee` (string, optional) — Reserved for Docusign.
- `featureSetId` (string, optional) — Reserved for Docusign.
- `fixedFee` (string, optional) — Reserved for Docusign.
- `is21CFRPart11` (string, optional) — Reserved for Docusign.
- `isActive` (string, optional) — Reserved for Docusign.
- `isEnabled` (string, optional) — When **true,** the feature set is actively enabled as part of the plan.
- `name` (string, optional) — Reserved for Docusign.
- `seatFee` (string, optional) — Reserved for Docusign.

### seatDiscount

This object contains information about a seat discount.

- `beginSeatCount` (string, optional) — Reserved for Docusign.
- `discountPercent` (string, optional) — The percent of the discount. Example: `"0.00"`
- `endSeatCount` (string, optional) — Reserved for Docusign.

### creditCardTypes

- `cardTypes` (list of string, optional) — An array containing supported credit card types.

### currencyFeatureSetPrice

Information about the price and currency associated with the feature set. Reserved for internal DocuSign use only.

- `currencyCode` (string, optional) — Specifies the alternate ISO currency code for the account.
- `currencySymbol` (string, optional) — Reserved for Docusign.
- `envelopeFee` (string, optional) — Reserved for Docusign.
- `fixedFee` (string, optional) — Reserved for Docusign.
- `seatFee` (string, optional) — Reserved for Docusign.

## Examples

**Response**

```json
{
  "billingPlan": {
    "appStoreProducts": [
      {
        "marketPlace": "sample string 1",
        "productId": "sample string 2"
      }
    ],
    "currencyPlanPrices": [
      {
        "currencyCode": "sample string 1",
        "currencySymbol": "sample string 2",
        "perSeatPrice": "sample string 3",
        "supportedCardTypes": {
          "cardTypes": [
            "sample string 1"
          ]
        },
        "supportIncidentFee": "sample string 4",
        "supportPlanFee": "sample string 5"
      }
    ],
    "enableSupport": "sample string 1",
    "includedSeats": "sample string 2",
    "otherDiscountPercent": "sample string 3",
    "paymentCycle": "sample string 4",
    "paymentMethod": "sample string 5",
    "perSeatPrice": "sample string 6",
    "planClassification": "sample string 7",
    "planFeatureSets": [
      {
        "currencyFeatureSetPrices": [
          {
            "currencyCode": "sample string 1",
            "currencySymbol": "sample string 2",
            "envelopeFee": "sample string 3",
            "fixedFee": "sample string 4",
            "seatFee": "sample string 5"
          }
        ],
        "envelopeFee": "sample string 1",
        "featureSetId": "sample string 2",
        "fixedFee": "sample string 3",
        "is21CFRPart11": "sample string 4",
        "isActive": "sample string 5",
        "isEnabled": "sample string 6",
        "name": "sample string 7",
        "seatFee": "sample string 8"
      }
    ],
    "planId": "sample string 8",
    "planName": "sample string 9",
    "seatDiscounts": [
      {
        "beginSeatCount": "sample string 1",
        "discountPercent": "sample string 2",
        "endSeatCount": "sample string 3"
      }
    ],
    "supportIncidentFee": "sample string 10",
    "supportPlanFee": "sample string 11"
  },
  "successorPlans": [
    {}
  ]
}
```