diff --git a/docs/sources/api/_index.md b/docs/sources/api/_index.md
index abd5ee03767f0..1515def55f3a4 100644
--- a/docs/sources/api/_index.md
+++ b/docs/sources/api/_index.md
@@ -155,6 +155,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples
@@ -277,12 +281,17 @@ Where `<matrix value>` is:
     <label key-value pairs>
   },
   "values": [
-    <number: second unix epoch>,
-    <string: value>
+    [
+      <number: second unix epoch>,
+      <string: value>
+    ],
+    ...
   ]
 }
 ```
 
+The items in the `values` array are sorted by timestamp, and the oldest item is first.
+
 And `<stream value>` is:
 
 ```
@@ -300,6 +309,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples