# NSwag

**Canonical:** https://apis.io/providers/nswag/  
**APIs profiled:** 1

NSwag is the Swagger/OpenAPI toolchain for .NET, ASP.NET Core and TypeScript, written in C# and maintained by Rico Suter under an MIT licence. It runs the contract in both directions: generating Swagger 2.0 and OpenAPI 3.0 documents from ASP.NET (Core) controllers, Web API assemblies and plain .NET types, and generating C# clients, ASP.NET Web API controllers and TypeScript clients back out of those documents. It combines what Swashbuckle and AutoRest do separately into a single toolchain, which is how it avoids the incompatibility seams between the two and gets better fidelity on inheritance, enums and reference handling via NJsonSchema. NSwag operates no hosted API of its own — it is consumed as NuGet packages, MSBuild targets, an npm-distributed CLI and NSwagStudio, a Windows GUI that authors and executes the same nswag.json configuration document the CLI runs.

## Kin Score — 23.5 / 100 (emerging)

Scored 2026-08-25 under rubric 0.14.0. Trend: flat (-0.7 from 24.2).

| Facet | Score |
|---|---|
| Discoverability | 59.3 |
| Contract Quality | 0.0 |
| Governance | 18.2 |
| Contract Governance | 18.2 |
| Operational Transparency | 31.6 |
| Developer Ergonomics | 40.5 |
| Commercial Clarity | 15.8 |
| Access Clarity | 15.8 |

## Agent readiness — 2.5 (human-only)

| Dimension | Value |
|---|---|
| Spec Presence | no |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | no |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## Access

Freemium — onboarding: unknown, pricing: freemium, trial: no (confidence: medium).

## APIs (1)

- **NSwag** — NSwag is an open source .NET toolchain for generating C# and TypeScript API clients and Swagger/OpenAPI specifications from ASP.NET controllers and vice versa. It ships as NuGet...

## Security (1)

- **Nswag Domain Security** — no transport/DNS hardening detected

## Plans (1)

- **Nswag Plans Pricing**

## Tags

.NET, ASP.NET Core, C#, Code Generation, Developer Tools, JSON-Schema, Open-Source, OpenAPI, SDK, Swagger, TypeScript

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/nswag/). Scores are computed from the provider's own public artifacts under a published rubric.