diff --git a/website/docs/reference/commands/run.md b/website/docs/reference/commands/run.md
index 26db40cb7e4..58a876f98ef 100644
--- a/website/docs/reference/commands/run.md
+++ b/website/docs/reference/commands/run.md
@@ -83,4 +83,15 @@ See [global configs](/reference/global-configs/print-output#print-color)
 
 The `run` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly.
 
-</VersionBlock>
\ No newline at end of file
+</VersionBlock>
+
+## Status codes
+
+When calling the [list_runs api](/dbt-cloud/api-v2#/operations/List%20Runs), you will get a status code for each run returned. The available run status codes are as follows:
+
+- Starting = 1
+- Running = 3
+- Success = 10
+- Error = 20
+- Canceled = 30
+- Skipped = 40