diff --git a/api-reference/dwh/get_spans.mdx b/api-reference/dwh/get_spans.mdx
new file mode 100644
index 0000000..1c90bc1
--- /dev/null
+++ b/api-reference/dwh/get_spans.mdx
@@ -0,0 +1,43 @@
+---
+title: "Get Spans"
+api: "GET https://api.traceloop.com/api/v2/warehouse/spans"
+---
+
+Get raw spans from the traceloop's datawarehouse, filtered by specific attributes.
+
+
+## Request Parameters
+
+<ParamField query="from_timestamp" type="int64">
+  From timestamp in milliseconds.
+</ParamField>
+
+<ParamField query="limit" type="int">
+  Maximum number of results to return. Default is 50, maximum is 1000.
+</ParamField>
+
+<ParamField query="cursor" type="int">
+  Pagination cursor. Default is 0.
+</ParamField>
+
+<ParamField query="workflow" type="string">
+  Filter spans by workflow name.
+</ParamField>
+
+## Response
+
+<ResponseField name="data" type="SpanDto[]">
+  Array of span data objects.
+</ResponseField>
+
+<ResponseField name="page_size" type="int">
+  Number of items returned in the current page.
+</ResponseField>
+
+<ResponseField name="total_results" type="int64">
+  Total number of results available.
+</ResponseField>
+
+<ResponseField name="next_cursor" type="string">
+  Cursor for the next page of results.
+</ResponseField>
diff --git a/mint.json b/mint.json
index af40d18..8bcfc95 100644
--- a/mint.json
+++ b/mint.json
@@ -165,6 +165,10 @@
       "group": "API Reference",
       "pages": ["api-reference/introduction"]
     },
+    {
+      "group": "Data Warehouse",
+      "pages": ["api-reference/dwh/get_spans"]
+    },
     {
       "group": "Tracing",
       "pages": [
@@ -182,9 +186,7 @@
     },
     {
       "group": "Costs",
-      "pages": [
-        "api-reference/costs/property_costs"
-      ]
+      "pages": ["api-reference/costs/property_costs"]
     }
   ],
   "redirects": [