updated filter docs

Author: tejas7777

pages/appointments/appointment-object.yml

@@ -173,6 +173,14 @@ filters:
     name: recipient
     type: integer
     description: Filter by the Appointment's linked Student (id).
+  -
+    name: client
+    type: integer
+    description: Filter by the Appointment's linked Client (id).
+  -
+    name: status
+    type: string
+    description: Filter by the Appointment's status. Possible values are `planned`, `awaiting-report`, `complete`, `cancelled`, and `cancelled-chargeable`.
   -
     name: location
     type: integer

pages/appointments/list-all-appointments.md

@@ -2,3 +2,6 @@
 
 Returns a list of your Appointments. The Appointments are sorted by `id`, with 
 the largest id first.
+
+You can filter appointments by client ID using the `client` parameter, and by 
+status using the `status` parameter. Multiple filters can be combined.

pages/appointments/list-all-appointments.py

@@ -1,5 +1,19 @@
 import pprint, requests
 
 headers = {'Authorization': 'token <API KEY>'}
+
+# Get all appointments
 r = requests.get('https://secure.tutorcruncher.com/api/appointments/', headers=headers)
 pprint.pprint(r.json())
+
+# Filter by client ID
+r = requests.get('https://secure.tutorcruncher.com/api/appointments/?client=123', headers=headers)
+pprint.pprint(r.json())
+
+# Filter by status
+r = requests.get('https://secure.tutorcruncher.com/api/appointments/?status=planned', headers=headers)
+pprint.pprint(r.json())
+
+# Filter by both client and status
+r = requests.get('https://secure.tutorcruncher.com/api/appointments/?client=123&status=complete', headers=headers)
+pprint.pprint(r.json())