diff --git a/docs/api/rest.md b/docs/api/rest.md
index 967ee48d..7c2e3f04 100644
--- a/docs/api/rest.md
+++ b/docs/api/rest.md
@@ -486,10 +486,9 @@ curl -X GET -H "Authorization: Bearer ABCDEFGH" \
 
 <ApiEndpoint path="/api/calendars/<calendar entity_id>" method="get">
 
-Returns the list of calendar events for the specified calendar entity_id between the `start` and `end` times (exclusive).
+Returns the list of [calendar events](/docs/core/entity/calendar/#calendarevent) for the specified calendar entity_id between the `start` and `end` times (exclusive).
 
 The events in the response have a `start` and `end` that contain either `dateTime` or `date` for an all day event.
-
 ```json
 [
   {
@@ -508,7 +507,9 @@ The events in the response have a `start` and `end` that contain either `dateTim
     },
     "end": {
       "dateTime": "2022-05-06T23:00:00-07:00"
-    }
+    },
+    "description": "Don't forget to bring balloons",
+    "location": "Brian's House"
   }
 ]
 ```