gocardless · jamiecobbett · May 14, 2026 · May 8, 2026 · May 13, 2026 · May 14, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,23 @@
 <!-- @format -->
 
+# 3.4.0
+
+- **Bug Fixes:**
+  - Fixed `JSONDecodeError` when calling endpoints that return `204 No Content` responses (e.g. `customers.remove()`) - fixes [#96](https://github.com/gocardless/gocardless-pro-python/issues/96)
+  - Fixed pagination cursor handling that was raising `KeyError` on endpoints without cursors (e.g. `institutions.list_for_billing_request`)
+  - Fixed POST/PUT request body envelope wrapping to use schema-defined envelopes instead of inferred ones
+  - Fixed invalid Python 3 syntax that was causing compatibility issues
+  - Improved error messages by including HTTP status code in malformed response errors
+
+- **Breaking Changes:**
+  - Removed Python 2 compatibility shim (Python 2 has been EOL for 6+ years, and this library already uses Python 3-only features like f-strings)
+  - Removed unused `six` dependency (was never actually imported in the codebase)
+  - Documented minimum Python version as 3.10
+
+- **Improvements:**
+  - README cleanup and documentation updates
+  - Added missing tests for paginator
+
 # 3.1.0
 - Added `mandate_request_constraints` to Billing Request templates
 - `constraints[max_amount_per_payment]` is required for Billing Requests Creation, if they contain PayTo `mandate_request`

diff --git a/README.rst b/README.rst
@@ -1,10 +1,10 @@
 .. |pypi-badge| image:: https://badge.fury.io/py/gocardless_pro.svg
     :target: https://pypi.python.org/pypi/gocardless_pro
 
-GoCardless Pro Python client library
+GoCardless Python client library
 ============================================
 
-A Python client for interacting with the GoCardless Pro API.
+A Python client for interacting with the GoCardless API.
 
 |pypi-badge|
 
@@ -62,10 +62,10 @@ Rate limit response headers can be read:
 
 .. code:: python
 
-    # Note these properties will be None until you make an API request with the client
-    client.rate_limit.limit
-    client.rate_limit.remaining
-    client.rate_limit.reset
+    # Note these values will be None until you make an API request with the client
+    client.rate_limit["ratelimit-limit"]
+    client.rate_limit["ratelimit-remaining"]
+    client.rate_limit["ratelimit-reset"]
 
 
 For full documentation, see our `API reference`_.

diff --git a/gocardless_pro/__init__.py b/gocardless_pro/__init__.py
@@ -1,6 +1,6 @@
-"""A client library for the GoCardless Pro API."""
+"""A client library for the GoCardless API."""
 
 from .client import Client
 
-__version__ = '3.3.0'
+__version__ = '3.4.0'
 
diff --git a/gocardless_pro/api_client.py b/gocardless_pro/api_client.py
@@ -172,7 +172,7 @@ def _default_headers(self):
             'Authorization': 'Bearer {0}'.format(self.access_token),
             'Content-Type': 'application/json',
             'GoCardless-Client-Library': 'gocardless-pro-python',
-            'GoCardless-Client-Version': '3.3.0',
+            'GoCardless-Client-Version': '3.4.0',
             'User-Agent': self._user_agent(),
             'GoCardless-Version': '2015-07-06',
         }
@@ -181,7 +181,7 @@ def _user_agent(self):
         python_version = '.'.join(platform.python_version_tuple()[0:2])
         vm_version = '{}.{}.{}-{}{}'.format(*sys.version_info)
         return ' '.join([
-            'gocardless-pro-python/3.3.0',
+            'gocardless-pro-python/3.4.0',
             'python/{0}'.format(python_version),
             '{0}/{1}'.format(platform.python_implementation(), vm_version),
             '{0}/{1}'.format(platform.system(), platform.release()),

diff --git a/gocardless_pro/api_response.py b/gocardless_pro/api_response.py
@@ -4,7 +4,7 @@
 #
 
 class ApiResponse(object):
-    """Response from the {{ .Config.api_name }} API, providing access
+    """Response from the GoCardless API, providing access
     to the status code, headers, and body.
     """
 
@@ -21,5 +21,8 @@ def headers(self):
 
     @property
     def body(self):
+        # Handle 204 No Content and other empty responses
+        if not self._response.content:
+            return {}
         return self._response.json()
 
diff --git a/gocardless_pro/client.py b/gocardless_pro/client.py
@@ -7,7 +7,7 @@
 from .api_client import ApiClient
 
 class Client(object):
-    """Client for interacting with the GoCardless Pro API.
+    """Client for interacting with the GoCardless API.
 
     Instantiate a client object with your access token and environment, then
     use the resource methods to access the API.
@@ -23,7 +23,7 @@ class Client(object):
     Example:
       client = Client(access_token=ACCESS_TOKEN, environment='sandbox')
       for customer in client.customers.list():
-          print '{} {}'.format(customer.family_name, customer.given_name)
+          print('{} {}'.format(customer.family_name, customer.given_name))
     """
 
     def __init__(self, access_token=None, environment=None, base_url=None, raise_on_idempotency_conflict=False):

diff --git a/gocardless_pro/list_response.py b/gocardless_pro/list_response.py
@@ -11,8 +11,10 @@ def __init__(self, records, api_response):
 
     @property
     def before(self):
-        return self.api_response.body['meta']['cursors']['before']
+        cursors = (self.api_response.body.get('meta') or {}).get('cursors') or {}
+        return cursors.get('before')
 
     @property
     def after(self):
-        return self.api_response.body['meta']['cursors']['after']
+        cursors = (self.api_response.body.get('meta') or {}).get('cursors') or {}
+        return cursors.get('after')
diff --git a/gocardless_pro/resources/customer_bank_account.py b/gocardless_pro/resources/customer_bank_account.py
@@ -76,6 +76,11 @@ def metadata(self):
         return self.attributes.get('metadata')
 
 
+    @property
+    def trusted_recipient(self):
+        return self.attributes.get('trusted_recipient')
+
+
 
 
 
@@ -112,3 +117,5 @@ def customer(self):
 
 
 
+
+
diff --git a/gocardless_pro/services/balances_service.py b/gocardless_pro/services/balances_service.py
@@ -10,7 +10,7 @@
 
 class BalancesService(base_service.BaseService):
     """Service class that provides access to the balances
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Balance

diff --git a/gocardless_pro/services/bank_account_details_service.py b/gocardless_pro/services/bank_account_details_service.py
@@ -10,7 +10,7 @@
 
 class BankAccountDetailsService(base_service.BaseService):
     """Service class that provides access to the bank_account_details
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BankAccountDetail

diff --git a/gocardless_pro/services/bank_account_holder_verifications_service.py b/gocardless_pro/services/bank_account_holder_verifications_service.py
@@ -10,7 +10,7 @@
 
 class BankAccountHolderVerificationsService(base_service.BaseService):
     """Service class that provides access to the bank_account_holder_verifications
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BankAccountHolderVerification

diff --git a/gocardless_pro/services/bank_authorisations_service.py b/gocardless_pro/services/bank_authorisations_service.py
@@ -10,7 +10,7 @@
 
 class BankAuthorisationsService(base_service.BaseService):
     """Service class that provides access to the bank_authorisations
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BankAuthorisation

diff --git a/gocardless_pro/services/bank_details_lookups_service.py b/gocardless_pro/services/bank_details_lookups_service.py
@@ -10,7 +10,7 @@
 
 class BankDetailsLookupsService(base_service.BaseService):
     """Service class that provides access to the bank_details_lookups
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BankDetailsLookup

diff --git a/gocardless_pro/services/billing_request_flows_service.py b/gocardless_pro/services/billing_request_flows_service.py
@@ -10,7 +10,7 @@
 
 class BillingRequestFlowsService(base_service.BaseService):
     """Service class that provides access to the billing_request_flows
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BillingRequestFlow

diff --git a/gocardless_pro/services/billing_request_templates_service.py b/gocardless_pro/services/billing_request_templates_service.py
@@ -10,7 +10,7 @@
 
 class BillingRequestTemplatesService(base_service.BaseService):
     """Service class that provides access to the billing_request_templates
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BillingRequestTemplate

diff --git a/gocardless_pro/services/billing_request_with_actions_service.py b/gocardless_pro/services/billing_request_with_actions_service.py
@@ -10,7 +10,7 @@
 
 class BillingRequestWithActionsService(base_service.BaseService):
     """Service class that provides access to the billing_request_with_actions
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BillingRequestWithAction

diff --git a/gocardless_pro/services/billing_requests_service.py b/gocardless_pro/services/billing_requests_service.py
@@ -10,7 +10,7 @@
 
 class BillingRequestsService(base_service.BaseService):
     """Service class that provides access to the billing_requests
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.BillingRequest

diff --git a/gocardless_pro/services/blocks_service.py b/gocardless_pro/services/blocks_service.py
@@ -10,7 +10,7 @@
 
 class BlocksService(base_service.BaseService):
     """Service class that provides access to the blocks
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Block

diff --git a/gocardless_pro/services/creditor_bank_accounts_service.py b/gocardless_pro/services/creditor_bank_accounts_service.py
@@ -10,7 +10,7 @@
 
 class CreditorBankAccountsService(base_service.BaseService):
     """Service class that provides access to the creditor_bank_accounts
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.CreditorBankAccount

diff --git a/gocardless_pro/services/creditors_service.py b/gocardless_pro/services/creditors_service.py
@@ -10,7 +10,7 @@
 
 class CreditorsService(base_service.BaseService):
     """Service class that provides access to the creditors
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Creditor

diff --git a/gocardless_pro/services/currency_exchange_rates_service.py b/gocardless_pro/services/currency_exchange_rates_service.py
@@ -10,7 +10,7 @@
 
 class CurrencyExchangeRatesService(base_service.BaseService):
     """Service class that provides access to the currency_exchange_rates
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.CurrencyExchangeRate

diff --git a/gocardless_pro/services/customer_bank_accounts_service.py b/gocardless_pro/services/customer_bank_accounts_service.py
@@ -10,7 +10,7 @@
 
 class CustomerBankAccountsService(base_service.BaseService):
     """Service class that provides access to the customer_bank_accounts
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.CustomerBankAccount

diff --git a/gocardless_pro/services/customer_notifications_service.py b/gocardless_pro/services/customer_notifications_service.py
@@ -10,7 +10,7 @@
 
 class CustomerNotificationsService(base_service.BaseService):
     """Service class that provides access to the customer_notifications
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.CustomerNotification

diff --git a/gocardless_pro/services/customers_service.py b/gocardless_pro/services/customers_service.py
@@ -10,7 +10,7 @@
 
 class CustomersService(base_service.BaseService):
     """Service class that provides access to the customers
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Customer

diff --git a/gocardless_pro/services/events_service.py b/gocardless_pro/services/events_service.py
@@ -10,7 +10,7 @@
 
 class EventsService(base_service.BaseService):
     """Service class that provides access to the events
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Event

diff --git a/gocardless_pro/services/exports_service.py b/gocardless_pro/services/exports_service.py
@@ -10,7 +10,7 @@
 
 class ExportsService(base_service.BaseService):
     """Service class that provides access to the exports
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Export

diff --git a/gocardless_pro/services/funds_availabilities_service.py b/gocardless_pro/services/funds_availabilities_service.py
@@ -10,7 +10,7 @@
 
 class FundsAvailabilitiesService(base_service.BaseService):
     """Service class that provides access to the funds_availabilities
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.FundsAvailability

diff --git a/gocardless_pro/services/instalment_schedules_service.py b/gocardless_pro/services/instalment_schedules_service.py
@@ -10,7 +10,7 @@
 
 class InstalmentSchedulesService(base_service.BaseService):
     """Service class that provides access to the instalment_schedules
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.InstalmentSchedule

diff --git a/gocardless_pro/services/institutions_service.py b/gocardless_pro/services/institutions_service.py
@@ -10,7 +10,7 @@
 
 class InstitutionsService(base_service.BaseService):
     """Service class that provides access to the institutions
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Institution

diff --git a/gocardless_pro/services/logos_service.py b/gocardless_pro/services/logos_service.py
@@ -10,7 +10,7 @@
 
 class LogosService(base_service.BaseService):
     """Service class that provides access to the logos
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Logo

diff --git a/gocardless_pro/services/mandate_import_entries_service.py b/gocardless_pro/services/mandate_import_entries_service.py
@@ -10,7 +10,7 @@
 
 class MandateImportEntriesService(base_service.BaseService):
     """Service class that provides access to the mandate_import_entries
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.MandateImportEntry

diff --git a/gocardless_pro/services/mandate_imports_service.py b/gocardless_pro/services/mandate_imports_service.py
@@ -10,7 +10,7 @@
 
 class MandateImportsService(base_service.BaseService):
     """Service class that provides access to the mandate_imports
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.MandateImport

diff --git a/gocardless_pro/services/mandate_pdfs_service.py b/gocardless_pro/services/mandate_pdfs_service.py
@@ -10,7 +10,7 @@
 
 class MandatePdfsService(base_service.BaseService):
     """Service class that provides access to the mandate_pdfs
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.MandatePdf

diff --git a/gocardless_pro/services/mandates_service.py b/gocardless_pro/services/mandates_service.py
@@ -10,7 +10,7 @@
 
 class MandatesService(base_service.BaseService):
     """Service class that provides access to the mandates
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.Mandate

diff --git a/gocardless_pro/services/negative_balance_limits_service.py b/gocardless_pro/services/negative_balance_limits_service.py
@@ -10,7 +10,7 @@
 
 class NegativeBalanceLimitsService(base_service.BaseService):
     """Service class that provides access to the negative_balance_limits
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.NegativeBalanceLimit

diff --git a/gocardless_pro/services/outbound_payment_import_entries_service.py b/gocardless_pro/services/outbound_payment_import_entries_service.py
@@ -10,7 +10,7 @@
 
 class OutboundPaymentImportEntriesService(base_service.BaseService):
     """Service class that provides access to the outbound_payment_import_entries
-    endpoints of the GoCardless Pro API.
+    endpoints of the GoCardless API.
     """
 
     RESOURCE_CLASS = resources.OutboundPaymentImportEntry