diff --git a/api-ref/source/server-migrations.inc b/api-ref/source/server-migrations.inc
index 61952b4da293..d958f744b7ee 100644
--- a/api-ref/source/server-migrations.inc
+++ b/api-ref/source/server-migrations.inc
@@ -64,6 +64,18 @@ Show Migration Details
 
 .. rest_method:: GET /servers/{server_id}/migrations/{migration_id}
 
+Show details for an in-progress live migration for a given server.
+
+.. note:: Microversion 2.23 or greater is required for this API.
+
+Policy defaults enable only users with the administrative role to perform
+this operation. Cloud providers can change these permissions through the
+``policy.json`` file.
+
+Normal response codes: 200
+
+Error response codes: unauthorized(401), forbidden(403), itemNotFound(404)
+
 Request
 -------