diff --git a/docs/sdk/python/usage-example.mdx b/docs/sdk/python/usage-example.mdx
index ae988a20..b751ea9a 100644
--- a/docs/sdk/python/usage-example.mdx
+++ b/docs/sdk/python/usage-example.mdx
@@ -183,6 +183,23 @@ ra = await permit.api.users.assign_role(
 )
 ```
 
+### List role assignments
+
+```py
+assignments = await permit.api.role_assignments.list(
+    tenant="tesla",
+    role="viewer",
+)
+```
+
+You can also filter for multiple roles:
+```py
+assignments = await permit.api.role_assignments.list(
+    tenant="tesla",
+    role=["viewer", "editor"],
+)
+```
+
 ## Checking Permissions
 
 ```py