diff --git a/doc/api/discussions.md b/doc/api/discussions.md
index 7d68d0ae744..3f575f432d0 100644
--- a/doc/api/discussions.md
+++ b/doc/api/discussions.md
@@ -2,6 +2,13 @@
 
 Discussions are set of related notes on snippets, issues, merge requests or commits.
 
+## Discussions pagination
+
+By default, `GET` requests return 20 results at a time because the API results
+are paginated.
+
+Read more on [pagination](README.md#pagination).
+
 ## Issues
 
 ### List project issue discussions
diff --git a/doc/api/notes.md b/doc/api/notes.md
index dd4e18b14e6..c351ee13d9a 100644
--- a/doc/api/notes.md
+++ b/doc/api/notes.md
@@ -2,6 +2,13 @@
 
 Notes are comments on snippets, issues or merge requests.
 
+## Notes pagination
+
+By default, `GET` requests return 20 results at a time because the API results
+are paginated.
+
+Read more on [pagination](README.md#pagination).
+
 ## Issues
 
 ### List project issue notes