diff --git a/doc/source/cli/command-objects/usage.rst b/doc/source/cli/command-objects/usage.rst
index 9cd0f70eb3..bb13176cc8 100644
--- a/doc/source/cli/command-objects/usage.rst
+++ b/doc/source/cli/command-objects/usage.rst
@@ -9,6 +9,9 @@ usage list
 
 List resource usage per project
 
+Compute API v2.40+ returns all matching entities rather than being
+limited to the API server configured maximum (``CONF.api.max_limit``).
+
 .. program:: usage list
 .. code:: bash
 
diff --git a/releasenotes/notes/usage-list-all-49ca7a62c50e71d3.yaml b/releasenotes/notes/usage-list-all-49ca7a62c50e71d3.yaml
new file mode 100644
index 0000000000..76a09cc546
--- /dev/null
+++ b/releasenotes/notes/usage-list-all-49ca7a62c50e71d3.yaml
@@ -0,0 +1,6 @@
+---
+fixes:
+  - |
+    Compute API v2.40+ returns all matching entities rather than being
+    limited to the API server configured maximum (``CONF.api.max_limit``).
+    [Story `2005099 <https://storyboard.openstack.org/#!/story/2005099>`_]