# /v1/payments/billing-agreements is deprecated

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

PayPal deprecated the /v1/payments/billing-agreements* endpoints without a shutdown date. PayPal REST API retains documentation only to support existing integrations, while calls will eventually fail as these resources are phased out. The endpoints handle legacy billing agreements and are no longer intended for new integrations.

## What to use instead

Move recurring payments to the Subscriptions API (/v1/billing/subscriptions). This transition requires more than updating an endpoint, as existing billing agreements do not carry over and buyers must approve the new subscriptions again.

Existing billing agreements do not carry over to subscriptions: moving means new subscriptions that buyers approve again.

- 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-agreements*`
- 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-agreements-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