{"openapi":"3.1.0","info":{"title":"Surplus Edge Supply Trust and Sales Agent API","version":"3.0.0","description":"Read evidence-gated industrial inventory, inspect Verified Asset Passports, work with a guarded sales agent and submit sourcing requirements. All commercial outputs are non-binding and financial commitments require human approval."},"servers":[{"url":"https://surplusedgesupply.com"}],"paths":{"/api/public/inventory":{"get":{"operationId":"searchVerifiedInventory","summary":"List evidence-gated inventory","responses":{"200":{"description":"Published inventory with verification status and passport URLs"}}}},"/api/public/inventory/{publicId}/passport":{"get":{"operationId":"getAssetPassport","summary":"Get one machine-readable Verified Asset Passport","parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Identity, provenance, evidence and commercial controls"},"404":{"description":"Passport not found or not public"}}}},"/api/public/trust":{"get":{"operationId":"getTrustMetrics","summary":"Read current verification policy and public catalog metrics","responses":{"200":{"description":"Trust controls and current counts"}}}},"/api/public/sales-agent":{"get":{"operationId":"getSalesAgentPolicy","summary":"Read sales-agent capabilities, limits and approval policy","responses":{"200":{"description":"Machine-readable agent policy"}}},"post":{"operationId":"workWithVerifiedSalesAgent","summary":"Qualify exact demand and prepare a non-binding offer draft","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["manufacturer","partNumber"],"properties":{"conversationId":{"type":"string"},"intent":{"type":"string"},"manufacturer":{"type":"string"},"partNumber":{"type":"string"},"quantity":{"type":"integer","minimum":1},"condition":{"type":"string"},"company":{"type":"string"},"contactName":{"type":"string"},"email":{"type":"string","format":"email"},"targetPrice":{"type":"number","minimum":0},"needBy":{"type":"string","format":"date"},"destination":{"type":"string"},"international":{"type":"boolean"},"paymentTerms":{"type":"string"},"requestedWarranty":{"type":"string"},"reserve":{"type":"boolean"},"purchase":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Verified match and non-binding offer draft; owner approval pending"},"202":{"description":"No exact public match; sourcing request queued"},"400":{"description":"Exact part identity missing"}}}},"/api/public/rfq":{"post":{"operationId":"submitRFQ","summary":"Submit a sourcing requirement","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["manufacturer","partNumber","company","contactName","email"],"properties":{"conversationId":{"type":"string"},"intent":{"type":"string"},"manufacturer":{"type":"string"},"partNumber":{"type":"string"},"quantity":{"type":"integer","minimum":1},"condition":{"type":"string"},"company":{"type":"string"},"contactName":{"type":"string"},"email":{"type":"string","format":"email"},"targetPrice":{"type":"number","minimum":0},"needBy":{"type":"string","format":"date"},"destination":{"type":"string"},"international":{"type":"boolean"},"paymentTerms":{"type":"string"},"requestedWarranty":{"type":"string"},"reserve":{"type":"boolean"},"purchase":{"type":"boolean"}}}}}},"responses":{"201":{"description":"RFQ recorded; no purchase or financial commitment created"},"400":{"description":"Invalid request"}}}}}}