diff --git a/apis/beacon/states/randao.yaml b/apis/beacon/states/randao.yaml
index f137b0e6..b32b1352 100644
--- a/apis/beacon/states/randao.yaml
+++ b/apis/beacon/states/randao.yaml
@@ -1,10 +1,14 @@
 get:
   operationId: "getStateRandao"
-  summary: "Get the RANDAO mix for some epoch."
+  summary: "Get the RANDAO mix for some epoch in a specified state."
   description: |
-    Fetch the RANDAO mix for a requested epoch from the state identified by `state_id`.
+    Fetch the RANDAO mix for the requested epoch from the state identified by `state_id`.
 
     If an epoch is not specified then the RANDAO mix for the state's current epoch will be returned.
+
+    By adjusting the `state_id` parameter you can query for any historic value of the RANDAO mix.
+    Ordinarily states from the same epoch will mutate the RANDAO mix for that epoch as blocks are
+    applied.
   tags:
     - Beacon
   parameters: