{"openapi":"3.0.2","info":{"title":"Zwivio Pricing API (internal)","description":"Platform fees by request type from JobTypeConfig default. The former public GET /api/public/pricing/v1/platform-fees is retired (410 Gone). Server-side callers (e.g. marketing SSR) use the internal endpoint with X-Zwivio-Internal-Pricing-Secret. Verified contractors may load fees through the pricing-access flow documented on /contractors/earnings.","version":"2.0.0"},"paths":{"/api/internal/pricing/v1/platform-fees":{"get":{"summary":"Get platform fees (internal, secret header)","description":"Returns platform fees by request type. Requires INTERNAL_PRICING_REQUEST_SECRET as header X-Zwivio-Internal-Pricing-Secret. Not for browser or anonymous clients.","parameters":[{"name":"X-Zwivio-Internal-Pricing-Secret","in":"header","required":true,"schema":{"type":"string"}},{"name":"serviceType","in":"query","required":true,"schema":{"type":"string","enum":["HVAC"]}},{"name":"market","in":"query","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"schema":{"type":"string"}},{"name":"county","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Platform fees by request type","content":{"application/json":{"schema":{"type":"object","properties":{"effective_at":{"type":"string","format":"date-time"},"currency":{"type":"string","example":"USD"},"pricing_scope":{"type":"string"},"service_type":{"type":"string"},"job_types":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"platform_fee_cents":{"type":"integer"}}}}}}}}},"400":{"description":"Invalid parameters"},"401":{"description":"Missing or invalid secret"}}}},"/api/public/pricing/v1/platform-fees":{"get":{"summary":"Deprecated — returns 410 Gone","description":"This path is retired. Use SMS verification on /contractors/earnings for contractor-facing fee disclosure, or the internal endpoint for trusted server renderers.","responses":{"410":{"description":"Gone — public anonymous fee JSON removed"}}}}}}