diff --git a/catalyst-gateway/Earthfile b/catalyst-gateway/Earthfile
index f41c71776dd..0b61c312c62 100644
--- a/catalyst-gateway/Earthfile
+++ b/catalyst-gateway/Earthfile
@@ -31,6 +31,9 @@ build-hosted:
 
     DO github.com/input-output-hk/catalyst-ci/earthly/rust:v2.0.11+SMOKE_TEST --bin="cat-gateway"
 
+    # generate OpenAPI docs
+    RUN ./target/$TARGETARCH/release/cat-gateway docs ./target/$TARGETARCH/doc/cat-gateway-api.json
+
     SAVE ARTIFACT target/$TARGETARCH/doc doc
     SAVE ARTIFACT target/$TARGETARCH/release/cat-gateway cat-gateway
 
diff --git a/docs/src/api/cat-gateway/openapi.md b/docs/src/api/cat-gateway/openapi.md
index eb2a60ff1f9..089d0506a29 100644
--- a/docs/src/api/cat-gateway/openapi.md
+++ b/docs/src/api/cat-gateway/openapi.md
@@ -4,8 +4,8 @@ icon: material/server
 
 # OpenAPI docs
 
+[OPEN FILE](./rust-docs/cat-gateway-api.json)
+
 ```JSON
-{
-    "name": "Alex",
-}
+    {{ include_file('src/api/cat-gateway/rust-docs/cat-gateway-api.json') }}
 ```
\ No newline at end of file