@@ -161,6 +161,20 @@ def refresh(self, **kwargs: Any) -> None:
 class ListMixin(HeadMixin[base.TObjCls]):
     _list_filters: tuple[str, ...] = ()
 
+    @overload
+    def list(
+        self,
+        *,
+        iterator: Literal[False] = False,
+        page: int | None = None,
+        **kwargs: Any,
+    ) -> list[base.TObjCls]: ...
+
+    @overload
+    def list(
+        self, *, iterator: Literal[True] = True, page: None = None, **kwargs: Any
+    ) -> base.RESTObjectList[base.TObjCls]: ...
+
     @exc.on_http_error(exc.GitlabListError)
     def list(
         self, **kwargs: Any