tsoa

At a glance

• Editor score
  6.8 / 10
• Pricing
  Free plan
• Best for
  TypeScript teams generating REST routes and specifications
• Free plan
  Yes
• Paid from
  Free
• Generation inputs
  TypeScript controller classes, decorators, models, and JSDoc comments
• Facts checked
  24 Sep 2026

• Where it wins

  • Generates OpenAPI/Swagger specs in JSON or YAML from controllers and models
  • Produces TypeScript route code with request and response validation
  • Decorator-based definitions retain TypeScript compile-time typing

• Where it doesn't

  • Focused on REST APIs rather than other API styles
  • Requires TypeScript controllers, decorators, models, and comments as inputs
  • Generated routes target Node.js applications and supported HTTP frameworks

Our verdict on tsoa

tsoa is an open-source TypeScript framework and code generator for REST APIs. Teams define controllers and request and response models with TypeScript classes, decorators, and comments; the tool generates OpenAPI/Swagger specifications and TypeScript route code with validation. It suits developers who want API definitions and generated routes within a TypeScript and Node.js application, rather than a general-purpose API design environment.

Its generation flow ties the API contract to code: inputs can include controller classes, decorators, models, and JSDoc comments, while outputs include OpenAPI specifications in JSON or YAML and generated TypeScript routes. Request and response validation is part of the route generation, and TypeScript compile-time typing supports API definitions. The project supports configured OpenAPI specification versions and connects generated routes with Node.js HTTP frameworks through runtime templates and middleware integrations. That focus is useful when teams want the specification and route implementation to follow their TypeScript definitions; it is less suited to teams designing APIs in another language or using a non-REST style.

The project is open source and free, with community and documentation support; generated artifacts can be incorporated into an application’s build and deployment process. Deployment is self-hosted, so teams manage the generated code as part of their own application rather than relying on a hosted service. Small, mid-market, and enterprise teams are listed as fits, but suitability depends on the TypeScript and Node.js stack. Choose tsoa when code-first REST route and specification generation are the goal; consider another approach if you need broader API-style coverage or a managed hosted workflow.

Your product? Our editors can test tsoa in depth and publish a review, labelled as paid · from $149/mo →

tsoa pricing

tsoa fact sheet

Alternatives to tsoa

• OpenAPI GeneratorFree, extensible OpenAPI generation for clients, servers, docs, and schemas.9.3
• HasuraA governed API platform with a free tier and model-based paid plans.8.7
• DreamFactoryA self-hosted API platform that turns data sources into documented, governed REST APIs.8.5

See all tsoa alternatives →

Featured on iTechGuides

tsoa is listed in our API Generation Software directory. Add the badge to your site — it links back to this page.

<a href="https://www.itechguides.com/products/tsoa/"><img src="https://www.itechguides.com/best/badge/tsoa.svg" alt="Featured on iTechGuides" width="230" height="46"></a>

Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026

Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.

Last updated 7 Oct 2026 · How we research and update