{"openapi":"3.1.0","info":{"title":"What Compliance knowledge and decision tools","version":"2026-11-03.3","description":"Read-only knowledge and stateless calculations. Source-checked draft guidance, specialist sign-off pending. Preserve jurisdiction and uncertainty. No lead creation or bookings.","contact":{"email":"whatcompliance@vividplanner.com"}},"servers":[{"url":"https://whatcompliance.com"}],"paths":{"/api/v1/topics":{"get":{"operationId":"listTopics","summary":"Filter source-linked topics","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"nation","in":"query","schema":{"enum":["","England","Wales","Scotland","Northern Ireland"]}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"compact","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Catalogue with source-check dates, editorial status, jurisdiction and sources","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Content unchanged; use ETag"},"400":{"description":"Invalid filter","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/topics/{id}":{"get":{"operationId":"getTopic","summary":"Read a guide, provenance and buying advice","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","schema":{"enum":["json","markdown"]}}],"responses":{"200":{"description":"Scoped guide with original sources and review status","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Topic not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/search":{"get":{"operationId":"searchGuidance","summary":"Find relevant guidance without AI","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Up to ten ranked source-linked results","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/plan":{"post":{"operationId":"buildStartingPlan","summary":"Build scoped starting points from explicit business facts","description":"No AI, storage or side effects. Does not determine compliance. Missing facts remain unknown; duties are withheld for an unconfirmed or mismatched nation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["profile"],"properties":{"profile":{"type":"object","additionalProperties":false,"properties":{"nation":{"enum":["","England","Wales","Scotland","Northern Ireland"]},"employees":{"type":["integer","null"],"minimum":0,"maximum":1000000},"sector":{"enum":["other","offices","shops","hospitality","property","trades","manufacturing","care","online"]},"premises":{"enum":["unknown","commercial","home","residential","none"]},"food":{"enum":["yes","no","unknown"]},"gas":{"enum":["yes","no","unknown"]},"water":{"enum":["yes","no","unknown"]},"olderBuilding":{"enum":["yes","no","unknown"]},"machinery":{"enum":["yes","no","unknown"]},"chemicals":{"enum":["yes","no","unknown"]},"screens":{"enum":["yes","no","unknown"]}}},"focus":{"type":"array","maxItems":3,"items":{"type":"string"}}}},"example":{"profile":{"nation":"England","employees":12,"sector":"offices","premises":"commercial","screens":"yes"}}}}},"responses":{"200":{"description":"Starting points, source links and unresolved questions","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid profile or focus","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/compare":{"post":{"operationId":"compareQuotes","summary":"Compare two prices with explicit VAT assumptions","description":"Returns integer pence. Prices and travel are per visit; extras are one-off. Does not recommend frequency, providers or VAT recovery.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quotes"],"properties":{"quotes":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","required":["price","visits","travel","extras","vat"],"properties":{"price":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"visits":{"type":"string","pattern":"^\\d+$"},"travel":{"type":"string"},"extras":{"type":"string"},"vat":{"enum":["exclusive","inclusive","none"]}}}}}},"example":{"quotes":[{"price":"100","visits":"1","travel":"20","extras":"0","vat":"exclusive"},{"price":"150","visits":"1","travel":"0","extras":"0","vat":"inclusive"}]}}}},"responses":{"200":{"description":"Gross and net totals in pence with difference and assumptions","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid quotes","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Profile":{"type":"object","additionalProperties":false,"properties":{"nation":{"enum":["","England","Wales","Scotland","Northern Ireland"]},"employees":{"type":["integer","null"],"minimum":0,"maximum":1000000},"sector":{"enum":["other","offices","shops","hospitality","property","trades","manufacturing","care","online"]},"premises":{"enum":["unknown","commercial","home","residential","none"]},"food":{"enum":["yes","no","unknown"]},"gas":{"enum":["yes","no","unknown"]},"water":{"enum":["yes","no","unknown"]},"olderBuilding":{"enum":["yes","no","unknown"]},"machinery":{"enum":["yes","no","unknown"]},"chemicals":{"enum":["yes","no","unknown"]},"screens":{"enum":["yes","no","unknown"]}}},"Quote":{"type":"object","required":["price","visits","travel","extras","vat"],"properties":{"price":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"visits":{"type":"string","pattern":"^\\d+$"},"travel":{"type":"string"},"extras":{"type":"string"},"vat":{"enum":["exclusive","inclusive","none"]}}}}}}