---
title: Billing Agreements v1
canonical: https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1
openapi_schema:
  json: https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.json
  yaml: https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.yaml
---

# Billing Agreements v1 (/api/deprecated/payments.billing-agreements/v1)

> This is an API reference page. The information below is a summary — the [JSON](https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.json) and [YAML](https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.yaml) schema are the preferred, authoritative source for exact parameters, request/response shapes, and validation rules.

## Base URL(s)

- https://api-m.sandbox.paypal.com

## Authentication

- Oauth2 (OAuth 2.0, clientCredentials)

## Operations

### billing-agreements

- `POST` [Create agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-post): Creates a billing agreement.
- `POST` [Execute agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-agreement-execute): Executes a billing agreement, by ID, after customer approval.
- `GET` [Show agreement details](/api/deprecated/payments.billing-agreements/v1/billing-agreements-get): Shows details for a billing agreement, by ID.
- `PATCH` [Update agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-patch): Updates details of a billing agreement, by ID.
- `POST` [Suspend agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-suspend): Suspends a billing agreement, by ID.
- `POST` [Reactivate agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-re-activate): Reactivates a suspended billing agreement, by ID.
- `POST` [Cancel agreement](/api/deprecated/payments.billing-agreements/v1/billing-agreements-cancel): Cancels a billing agreement, by ID.
- `POST` [Bill agreement balance](/api/deprecated/payments.billing-agreements/v1/billing-agreements-bill-balance): Bills the balance for an agreement, by ID.
- `POST` [Set agreement balance](/api/deprecated/payments.billing-agreements/v1/billing-agreements-set-balance): Sets the balance for an agreement, by ID.
- `GET` [List agreement transactions](/api/deprecated/payments.billing-agreements/v1/billing-agreements-transactions): Lists transactions for an agreement, by ID.

## Full schema

The list above is a summary. Full parameter, request, and response detail for every operation lives in the schema: [JSON](https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.json) · [YAML](https://developer.paypal.com/api/deprecated/payments.billing-agreements/v1/schema.yaml)