---
title: "List billing agreements"
method: GET
path: "/paypal/billing_agreements"
---

# List billing agreements

`GET /paypal/billing_agreements`

## Request

- Base URL: `https://gateway.pmnts-sandbox.io/v1.0`
- URL: `https://gateway.pmnts-sandbox.io/v1.0/paypal/billing_agreements`
- Auth: HTTP basic

## Query parameters

- `offset` integer
- `limit` integer
- `from` string, date
- `to` string, date

## Headers

- `Content-Type` string

## Response `200`

200

- object
  - `successful` boolean
  - `response` object[]
    - `id` string
    - `name` string
    - `description` string
    - `state` string
    - `payer` object
      - `payer_info` object
        - `email` string
        - `first_name` string
        - `last_name` string
        - `payer_id` string
    - `shipping_address` object
      - `first_name` string
      - `last_name` string
      - `address_1` string
      - `address_2` string
      - `city` string
      - `state` string
      - `postcode` string
      - `country` string
    - `merchant_custom_data` string
    - `created_at` string
  - `errors` unknown[]
    - unknown
  - `records` integer
  - `total_records` integer
  - `page` integer
  - `total_pages` integer

## Changes

- **2026-11-03** `a62ddbae3800`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fatzebra/apis/gateway/changes/paypal/billing_agreements/get.md)

---

[API](https://skmtc.dev/fatzebra/apis/gateway.md) - [All operations](https://skmtc.dev/fatzebra/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fatzebra/apis/gateway/revisions/a62ddbae3800?raw)