Merge pull request #88 from seunfapps/chore/filter-subscriptions

Add functionality to filter subscriptions

Author: andela-sjames

docs/subscription.md

@@ -42,9 +42,12 @@ from paystackapi.subscription import Subscription
 response = Subscription.list()
 ```
 
-*Arguments*
+*Optional Arguments*
 
-No argument required.
+- `perPage`: Number of results per page.
+- `page`: Pagination page number. 
+- `customer`: Customer ID
+- `plan`: Plan ID
 
 *Returns*
 

paystackapi/subscription.py

@@ -23,17 +23,20 @@ def create(cls, **kwargs):
         return cls().requests.post('subscription', data=kwargs)
 
     @classmethod
-    def list(cls):
+    def list(cls, **kwargs):
         """
         List subscriptions.
 
-        Args:
-            No argument required.
+        Optional Args:
+            perPage: Number of subscriptions listed per page for pagination
+            page: pagination page number.
+            customer: Customer ID.
+            plan: Plan ID.
 
         Returns:
             Json data from paystack API.
         """
-        return cls().requests.get('subscription')
+        return cls().requests.get('subscription', qs=kwargs)
 
     @classmethod
     def disable(cls, **kwargs):