diff --git a/docs/reference/cat.asciidoc b/docs/reference/cat.asciidoc
index d557a8c930a20..62d5165984aa5 100644
--- a/docs/reference/cat.asciidoc
+++ b/docs/reference/cat.asciidoc
@@ -255,16 +255,18 @@ include::cat/recovery.asciidoc[]
 
 include::cat/repositories.asciidoc[]
 
-include::cat/tasks.asciidoc[]
-
-include::cat/thread_pool.asciidoc[]
-
-include::cat/trainedmodel.asciidoc[]
-
 include::cat/shards.asciidoc[]
 
 include::cat/segments.asciidoc[]
 
 include::cat/snapshots.asciidoc[]
 
+include::cat/tasks.asciidoc[]
+
 include::cat/templates.asciidoc[]
+
+include::cat/thread_pool.asciidoc[]
+
+include::cat/trainedmodel.asciidoc[]
+
+include::cat/transform.asciidoc[]
diff --git a/docs/reference/cat/transform.asciidoc b/docs/reference/cat/transform.asciidoc
new file mode 100644
index 0000000000000..835106c08b496
--- /dev/null
+++ b/docs/reference/cat/transform.asciidoc
@@ -0,0 +1,28 @@
+[[cat-transform]]
+=== cat transform API
+++++
+<titleabbrev>cat transform</titleabbrev>
+++++
+
+Returns configuration and usage information about {transforms}.
+
+
+[[cat-transform-api-request]]
+==== {api-request-title}
+
+`GET /_cat/transform`
+
+
+//[[cat-transform-api-desc]]
+//==== {api-description-title}
+
+
+//[[cat-transform-api-query-params]]
+//==== {api-query-parms-title}
+
+
+//[[cat-transform-api-response-codes]]
+//==== {api-response-codes-title}
+
+//[[cat-transform-api-examples]]
+//==== {api-examples-title}