{"openapi":"3.0.3","info":{"title":"SupplierClear API","version":"1.0.0","description":"Pre-PO engineering decision intelligence — evaluate supplier quotes before commitment. Includes clarity explain endpoint for embed panels."},"servers":[{"url":"/api/v1"}],"paths":{"/v1/evaluate":{"post":{"summary":"Evaluate a single supplier readiness assessment","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"AssessmentInput (jurisdiction, decisionType, intake, answers)"},"responses":{"200":{"description":"DecisionResult with SupplierClearTrace"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/compare":{"post":{"summary":"Compare up to three supplier assessments","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{ assessments: AssessmentInput[] }"},"responses":{"200":{"description":"{ results, recommendedIndex, comparisonSummary }"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/clarity/explain":{"post":{"summary":"Plain-language readiness explanation for embed and procurement panels","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{ result: DecisionResult, context?: procurement | engineering }"},"responses":{"200":{"description":"{ bandExplanation, blockers[], recommendedAction, provenanceNote, band, fatalFlawCodes[] }"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/reports/{reportId}":{"get":{"summary":"Retrieve a paid report by reportId","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Report with assessment and result snapshots"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/connect/assess":{"post":{"summary":"Persist assessment and return DecisionPackage (Connect)","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"{ assessment, externalRef?, idempotencyKey? }"},"responses":{"200":{"description":"{ assessmentId, decisionPackage }"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/connect/assessments/{id}/decision-package":{"get":{"summary":"Machine-readable DecisionPackage with optional briefs/redTeam","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"DecisionPackage"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}},"/v1/connect/assessments/{id}/assurance-package":{"get":{"summary":"Decision Assurance Package with HMAC seal","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"{ assurancePackageId, hmacSeal, decisionPackage }"},"400":{"description":"Bad request"},"401":{"description":"Missing or invalid API key"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key"}}}}