{"name":"TrueTotal True Cost Engine","description":"Headless, schema-first engine that computes the whole-life true total cost (base price + every hidden cost − resale) of travel, yachts, villas and premium experiences. Rankings are never for sale.","version":"v1","vocabulary":"https://truetotalcalculator.com/schema#","assetClasses":["holiday","yacht_charter","villa_rental","activity","generic"],"tenants":[{"id":"truetotal","currency":"EUR","locale":"en-IE"},{"id":"truetotal-uk","currency":"GBP","locale":"en-GB"}],"endpoints":[{"method":"GET","path":"/api/v1/health","desc":"Service + FX status."},{"method":"GET","path":"/api/v1/listings","desc":"List computed listings. Query: assetClass, region, currency, tenant, limit, offset."},{"method":"GET","path":"/api/v1/listings/{id}","desc":"One listing with full true-cost breakdown + schema.org JSON-LD + verifiability. Query: currency, tenant."},{"method":"GET","path":"/api/v1/listings/{id}/provenance","desc":"Full \"show your work\" trace: every figure resolved to its original value source + the verifiability score."},{"method":"GET","path":"/api/v1/sources","desc":"The canonical source registry every figure cites (resolve a provenance sourceId to its origin)."},{"method":"GET","path":"/api/v1/listings/{id}/history","desc":"Captured append-only price history (base + true total per observation)."},{"method":"POST","path":"/api/v1/true-cost","desc":"Compute a true total from a base price + params. Body: {assetClass, basePrice:{amount,currency}, partySize?, params?, displayCurrency?}."}],"example":{"request":"https://www.truetotalcalculator.com/api/v1/true-cost","body":{"assetClass":"yacht_charter","basePrice":{"amount":42000,"currency":"EUR"},"partySize":8,"params":{"apaPct":0.3,"deliveryFuel":3000,"portFees":900},"displayCurrency":"USD"}},"honesty":{"grades":["FACT","SOURCED","ASSUMPTION"],"note":"Every figure carries a confidence grade + source + date. Illustrative seed data is labelled; production uses real, dated feeds."}}