List Subscription Payments

Lists all paid and upcoming (unpaid) subscription payments.

This will return all subscription payments (including one-off charges) by default.

  • vendor_id: int; required. Vendor ID
  • vendor_auth_code: string; required. See API Authentication documentation for instructions.
  • plan: int; optional. The subscription plan id (single or comma-separated values)
  • subscription_id: int; optional. The specific user subscription id.
  • is_paid: int; optional. Is the payment paid? (0 = No, 1 = Yes)
  • is_one_off_charge: int; optional. Return one-off charges? By default, returns both recurring payments as well as one-off charges (0 = only return recurring payments, 1 = only return one-off charges)
  • from: yyyy-mm-dd; optional. Subscription payments that occurred after the date specified.
  • to: yyyy-mm-dd; optional. Subscription payments that occurred before the date specified.

Example Request

curl -X POST \
     -d 'vendor_id=123...' \
     -d 'vendor_auth_code=1g3g456abc' \
     -d 'subscription_id=2746' \
     -d 'is_one_off_charge=1' \
     -d 'from=2017-10-29' \
     -d 'to=2017-11-20' \

Example Response

    "success": true,
    "response": [
            "id": 8936,
            "subscription_id": 2746,
            "amount": 1,
            "currency": "USD",
            "payout_date": "2015-10-15",
            "is_paid": 0,
            "is_one_off_charge": 1,
            "receipt_url": ""

Questions about Paddle?

If you need any help regarding your Paddle integration, please get in touch with our Customer Success team using the form below.