{"openapi":"3.1.0","info":{"title":"LucidLoyalty API","version":"0.2.0","description":"Foundation API contract for loyalty event evaluation."},"servers":[{"url":"https://lucidloyalty.com"}],"paths":{"/api/health":{"get":{"summary":"Service health"}},"/api/v1/quote":{"post":{"summary":"Quote points for a purchase","requiredHeaders":["Idempotency-Key (production ledger posting)"]}},"/api/v1/redeem":{"post":{"summary":"Validate a reward redemption","requiredHeaders":["Idempotency-Key (production ledger posting)"]}}},"principles":["External business events are separate from loyalty ledger events.","Posted ledger events are immutable; corrections are compensating entries.","Production mutations require tenant scope, authentication and idempotency.","Point and tier decisions are deterministic application logic, not AI decisions."]}