# dotnet/aspnet-api-versioning

Provides a set of libraries which add service API versioning to ASP.NET Core Minimal APIs, Controllers, gRPC, OData, and Web API (Classic).

Repository: https://github.com/dotnet/aspnet-api-versioning
Canonical: https://ross.abutalabs.com/products/aspnet-api-versioning
Language: C#
License: MIT
License Family: permissive
Topics: aspnet, aspnetcore, versioning, versioning-semantics, odata, webapi
Last push: 2026-08-22T21:09:51+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 72, longevity 100
- inputs: {"age_days": 3690, "days_push": 11, "days_rel": 27, "gap_med": 106, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3205, forks 721 (observed 2026-08-28T04:07:48.620784+00:00)

## What it is
A set of .NET libraries that add API versioning semantics to ASP.NET Core services, including Minimal APIs, MVC controllers, gRPC, OData, and classic Web API. It uses metadata attributes and conventions compliant with Microsoft REST guidelines without requiring changes to routing or service implementation.

## Use cases
- version a REST API in ASP.NET Core
- support multiple API versions side by side
- add versioning to minimal APIs
- version OData or gRPC services
- migrate legacy services to versioned APIs
- implement Microsoft REST guideline versioning

## When to choose
- you build REST services with ASP.NET Core and need versioning
- you want standards-compliant versioning with minimal code changes
- you support multiple API versions across controllers, minimal APIs, gRPC, or OData

## When to avoid
- your project is not on the .NET/ASP.NET stack
- you need client-side API versioning rather than server-side
- you use a non-ASP.NET web framework

## Facets
- artifact type: library
- maturity: active
- function: middleware, routing, api-framework, web-framework
- domain: web-development, backend, apis, developer-tools
- platform: dotnet, cross-platform
- tags: api-versioning, aspnetcore, rest, odata, grpc, minimal-apis, web-server

## Member repositories
- dotnet/aspnet-api-versioning (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:48.620784+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:44:58.348065+00:00, confidence not recorded.
  - readme: https://github.com/dotnet/aspnet-api-versioning (fetched 2026-08-28T04:07:48.620784+00:00, sha 6a96fe5912e5)
- Data as of 2026-08-30T08:39:29.467469+00:00.