From 3ac58475b6f5c86fe9f7f526f446b0673b6a0f1e Mon Sep 17 00:00:00 2001
From: Severin Ibarluzea <seve700@gmail.com>
Date: Sun, 22 Jun 2025 19:59:19 -0700
Subject: [PATCH] Refine Order Quote docs

---
 docs/web-apis/ordering-api.mdx | 45 ++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/docs/web-apis/ordering-api.mdx b/docs/web-apis/ordering-api.mdx
index 1d34b81..4f4e31b 100644
--- a/docs/web-apis/ordering-api.mdx
+++ b/docs/web-apis/ordering-api.mdx
@@ -107,9 +107,50 @@ curl -X GET "https://api.tscircuit.com/orders/get?order_id=123e4567-e89b-12d3-a4
   "message": "string"
 }
 ```
-- For endpoints related to order quotes, see the Order Quotes API documentation.
+## Order Quote API
+
+The Order Quote API lets you retrieve pricing quotes for PCB orders. Quotes include component pricing, PCB costs, shipping options, and overall totals.
+
+### Endpoint
+
+#### Get an Order Quote
+`GET /order_quotes/get?order_quote_id={uuid}` or `POST /order_quotes/get`
+
+Request body:
+
+```json
+{
+  "order_quote_id": "string (UUID)"
+}
+```
+
+Response example:
+
+```json
+{
+  "order_quote": {
+    "order_quote_id": "123e4567-e89b-12d3-a456-426614174000",
+    "vendor_name": "jlcpcb",
+    "is_completed": true,
+    "quoted_components": [
+      {
+        "manufacturer_part_number": "CC0603KRX7R9BB101",
+        "quantity": 10,
+        "total_cost": 0.5,
+        "available": true
+      }
+    ],
+    "bare_pcb_cost": 20.0,
+    "shipping_options": [
+      { "carrier": "dhl", "service": "express", "cost": 9.5 }
+    ],
+    "total_cost_without_shipping": 25.0
+  }
+}
+```
+
+Returns `404` if the quote is not found or not accessible.
 
 ## See Also
 
-- [Order Quotes API Documentation](#)
 - [Authentication Guide](#)