Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

List PricingPlanVersions v2

List all versions of a PricingPlan.

Learn more about calling API v2 endpoints.

Parameters

  • pricing_plan_idstringRequired

    The ID of the PricingPlan to list versions for.

  • limitinteger

    Optionally set the maximum number of results per page. Defaults to 20.

  • pagestring

    A cursor for use in pagination.

Returns

Response attributes

  • dataarray of objects

    List of PricingPlanVersions.

  • next_page_urlnullable string

    The URL to get the next page of results, if there are any.

  • previous_page_urlnullable string

    The URL to get the previous page of results, if there are any.

Error Codes
404pricing_plan_not_found

Returned when the provided pricing_plan ID cannot be found.

GET /v2/billing/pricing_plans/:id/versions
curl https://api.stripe.com/v2/billing/pricing_plans/bpp_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy/versions \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "data": [
    {
      "created": "2025-01-01T00:00:00.000Z",
      "end_date": "2025-12-31T23:59:59.000Z",
      "id": "bppv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy",
      "object": "v2.billing.pricing_plan_version",
      "pricing_plan": "bpp_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy",
      "start_date": "2025-01-01T00:00:00.000Z",
      "livemode": true
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Delete a PricingPlanComponent v2

Remove a PricingPlanComponent from the latest version of a PricingPlan.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    The ID of the PricingPlanComponent to remove.

  • pricing_plan_idstringRequired

    The ID of the PricingPlan.

Returns

Response attributes

  • idstring

    The ID of the PricingPlanComponent that was removed.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

Error Codes
400pricing_plan_component_delete_inactive

Returned when trying to remove a pricing plan component that is not available in the latest pricing plan version.

400pricing_plan_inactive

Returned when trying to create or modify a subscription for an inactive pricing plan.

404pricing_plan_component_not_found

Returned when the provided pricing_plan_component ID cannot be found.

404pricing_plan_not_found

Returned when the provided pricing_plan ID cannot be found.

DELETE /v2/billing/pricing_plans/:id/components/:id
curl -X DELETE https://api.stripe.com/v2/billing/pricing_plans/bpp_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy/components/bppc_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "id": "bppc_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy",
  "object": "v2.billing.pricing_plan_component"
}

Pricing Plan Subscriptions v2

A PricingPlanSubscription links a PricingPlan to a specific billing Cadence. While the PricingPlanSubscription is active, Stripe will bill the Payer according to the PricingPlan’s components.

Learn more about calling API v2 endpoints.
Endpoints

Quote 

A Quote is a way to model prices that you’d like to provide to a customer. Once accepted, it will automatically create an invoice, subscription or subscription schedule.

Endpoints

Subscriptions 

Subscriptions allow you to charge a customer on a recurring basis.

Related guide: Creating subscriptions

Endpoints