{"openapi":"3.1.0","info":{"title":"Tomcabs Public API","version":"1.0.0","description":"Public discovery metadata for Tomcabs. Authenticated workspace APIs are private and not documented for public agent access in this version.","contact":{"email":"support@tomcabs.com"}},"servers":[{"url":"https://www.tomcabs.com","description":"Tomcabs production origin"}],"x-service-info":{"category":"Taxi operations management software","audience":"Small and medium taxi companies, taxi managers, fleet managers, and drivers","commerce":{"x402":"not_supported","mpp_payable_operations":false,"note":"Tomcabs does not expose payable agent-native HTTP operations in this version."}},"paths":{"/api/health":{"get":{"operationId":"getHealth","summary":"Get public service health","security":[],"responses":{"200":{"description":"Service health response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"service":{"type":"string"},"version":{"type":"string"},"origin":{"type":"string","format":"uri"},"checked_at":{"type":"string","format":"date-time"}},"required":["status","service","version","origin","checked_at"]}}}}}}},"/.well-known/api-catalog":{"get":{"operationId":"getApiCatalog","summary":"Get the Tomcabs API catalog linkset","security":[],"responses":{"200":{"description":"RFC 9727 API catalog","content":{"application/linkset+json":{"schema":{"type":"object","properties":{"linkset":{"type":"array"}},"required":["linkset"]}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"operationId":"getOAuthProtectedResource","summary":"Get OAuth protected resource metadata","security":[],"responses":{"200":{"description":"OAuth protected resource metadata"}}}},"/api/billing-state":{"get":{"operationId":"getBillingState","summary":"Resolve billing banner state for an authenticated manager session","description":"Protected internal application endpoint. It requires a signed-in Tomcabs session and does not expose public billing data.","security":[{"bearerAuth":[]}],"parameters":[{"name":"companyId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Billing banner state for an authorized company"},"401":{"description":"Authentication required"},"403":{"description":"Company access denied"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Tomcabs uses Supabase Auth. Discover OAuth metadata at https://www.tomcabs.com/.well-known/openid-configuration."}}}}