# /v1/payments/billing-plans is deprecated

PayPal REST API deprecated /v1/payments/billing-plans* without giving a shutdown date yet.

PayPal has deprecated the /v1/payments/billing-plans* endpoints without a shutdown date. Calls to these resources are intended only to support existing integrations and will eventually fail. PayPal REST API advises that new integrations and existing users seeking upgrades transition away from these resources.

## What to use instead

Create and manage plans with the Subscriptions API (/v1/billing/plans).

- API: PayPal REST API (api-m.paypal.com)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/v1/payments/billing-plans*`
- Source: [Announcement](https://developer.paypal.com/api/rest/deprecated-resources/)
- Verified: November 6, 2026, against PayPal REST API's own pages
- Page: https://www.okapi.bot/providers/paypal-rest-api/breaking-changes/v1-payments-billing-plans-is-deprecated/

## PayPal REST API's words

> The resources listed here are deprecated. Information on these reference pages is to support customers with existing integrations only. For new integrations or users interested in upgrading, use our current offerings.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent
