# /v1/payments/billing-agreements is deprecated

api-m.sandbox.paypal.com deprecated /v1/payments/billing-agreements* without giving a shutdown date yet.

The provider deprecated the /v1/payments/billing-agreements* endpoints without a shutdown date. Calls to these resources are intended to support existing integrations only, but will eventually fail under this removal. The reference pages remain available strictly for maintaining current implementations rather than creating new ones.

## 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 to subscriptions 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: api-m.sandbox.paypal.com (api-m.sandbox.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: October 29, 2026, against api-m.sandbox.paypal.com's own pages
- Page: https://www.okapi.bot/providers/api-m-sandbox-paypal-com/breaking-changes/v1-payments-billing-agreements-is-deprecated/

## api-m.sandbox.paypal.com'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