{"openapi":"3.1.0","info":{"title":"Mandarin 3D API","version":"0.2.0","description":"Quote and order custom 3D prints (PLA) shipped anywhere in the US by USPS in 3-5 days. No key needed. For AI assistants there is also a remote MCP server at https://mandarin3d.com/mcp.","contact":{"email":"orders@mandarin3d.com","url":"https://mandarin3d.com/docs"}},"servers":[{"url":"https://mandarin3d.com"}],"paths":{"/api/config":{"get":{"operationId":"getConfig","summary":"Price formula, colors, shipping table and limits","responses":{"200":{"description":"Config","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/quote":{"post":{"operationId":"quoteFile","summary":"Slice a model and price it","description":"STL, 3MF or STEP up to 100 MB. Multipart field `file`, or raw bytes with ?filename=part.stl. Takes 5-60 s for a new file; repeats are cached.","parameters":[{"name":"filename","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"filename":{"type":"string"},"grams":{"type":"number"},"seconds":{"type":"number","description":"Estimated print time per part."},"bbox":{"type":"array","items":{"type":"number"},"description":"Size in mm."},"warnings":{"type":"array","items":{"type":"string"}},"url":{"type":"string","description":"Page where a person can pick a color and pay."},"example":{"type":"object","properties":{"qty":{"type":"integer"},"unit":{"type":"number"},"print":{"type":"number","description":"Print price including the $3.50 setup."},"shipping":{"type":["number","null"]},"shippingLabel":{"type":"string"},"optionsTotal":{"type":"number"},"total":{"type":["number","null"],"description":"USD, delivered. Null if too heavy for the shipping table."}}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/quote/{id}":{"get":{"operationId":"getQuote","summary":"Read a quote","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"filename":{"type":"string"},"grams":{"type":"number"},"seconds":{"type":"number","description":"Estimated print time per part."},"bbox":{"type":"array","items":{"type":"number"},"description":"Size in mm."},"warnings":{"type":"array","items":{"type":"string"}},"url":{"type":"string","description":"Page where a person can pick a color and pay."},"example":{"type":"object","properties":{"qty":{"type":"integer"},"unit":{"type":"number"},"print":{"type":"number","description":"Print price including the $3.50 setup."},"shipping":{"type":["number","null"]},"shippingLabel":{"type":"string"},"optionsTotal":{"type":"number"},"total":{"type":["number","null"],"description":"USD, delivered. Null if too heavy for the shipping table."}}}}}}}},"202":{"description":"Still waiting or slicing","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["waiting","slicing","error"]}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/price":{"post":{"operationId":"priceQuote","summary":"Price a quote for a quantity, color and options. No side effects.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quoteId"],"properties":{"quoteId":{"type":"string"},"qty":{"type":"integer","minimum":1,"maximum":100},"color":{"type":"string","enum":["BLK","WHT","GRY","RED","BLU","GRN"]},"options":{"type":"object","properties":{"rush":{"type":"boolean","description":"+50% of the print price; printed within 1 business day."},"fileCheck":{"type":"boolean","description":"+$5; printability and fit review before printing."},"cleanup":{"type":"boolean","description":"+$5; support marks sanded, edges deburred."},"extraColors":{"type":"array","items":{"type":"string","enum":["BLK","WHT","GRY","RED","BLU","GRN"]},"maxItems":3,"description":"+$3 per extra stocked color."},"colorNote":{"type":"string","maxLength":140,"description":"Which parts get which color; required with extraColors."}}}}}}}},"responses":{"200":{"description":"Price","content":{"application/json":{"schema":{"type":"object","properties":{"qty":{"type":"integer"},"unit":{"type":"number"},"print":{"type":"number","description":"Print price including the $3.50 setup."},"shipping":{"type":["number","null"]},"shippingLabel":{"type":"string"},"optionsTotal":{"type":"number"},"total":{"type":["number","null"],"description":"USD, delivered. Null if too heavy for the shipping table."}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/checkout":{"post":{"operationId":"createCheckout","summary":"Create a payment link","description":"Only with the customer's explicit acceptance of: \"Custom made to order, all sales final. I agree to the Terms (mandarin3d.com/terms, including section 6: cancellations, refunds and reprints).\" The customer pays and enters the address at invoiceUrl.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quoteId","color","acceptTerms"],"properties":{"quoteId":{"type":"string"},"color":{"type":"string","enum":["BLK","WHT","GRY","RED","BLU","GRN"]},"qty":{"type":"integer","minimum":1,"maximum":100},"options":{"type":"object","properties":{"rush":{"type":"boolean","description":"+50% of the print price; printed within 1 business day."},"fileCheck":{"type":"boolean","description":"+$5; printability and fit review before printing."},"cleanup":{"type":"boolean","description":"+$5; support marks sanded, edges deburred."},"extraColors":{"type":"array","items":{"type":"string","enum":["BLK","WHT","GRY","RED","BLU","GRN"]},"maxItems":3,"description":"+$3 per extra stocked color."},"colorNote":{"type":"string","maxLength":140,"description":"Which parts get which color; required with extraColors."}}},"acceptTerms":{"type":"boolean","const":true}}}}}},"responses":{"200":{"description":"Checkout","content":{"application/json":{"schema":{"type":"object","properties":{"checkoutId":{"type":"string"},"invoiceUrl":{"type":"string"},"price":{"type":"object","properties":{"qty":{"type":"integer"},"unit":{"type":"number"},"print":{"type":"number","description":"Print price including the $3.50 setup."},"shipping":{"type":["number","null"]},"shippingLabel":{"type":"string"},"optionsTotal":{"type":"number"},"total":{"type":["number","null"],"description":"USD, delivered. Null if too heavy for the shipping table."}}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"502":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}