--- title: All You Want to Know About Spring API Versioning | daily.dev description: A walkthrough of the new API versioning feature introduced in Spring Framework 7 (bundled with Spring Boot 4), covering the four built-in strategies: header,... canonical: https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: All You Want to Know About Spring API Versioning | daily.dev og:description: A walkthrough of the new API versioning feature introduced in Spring Framework 7 (bundled with Spring Boot 4), covering the four built-in strategies: header,... og:url: https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe og:image: https://api.daily.dev/og/posts/dpwGIpoBE.png og:image:alt: All You Want to Know About Spring API Versioning og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # All You Want to Know About Spring API Versioning **[SivaLabs \(YouTube\)](https://daily.dev/sources/sivalabs-youtube)** · 25 min read · 0 upvotes · 0 comments ## Summary A walkthrough of the new API versioning feature introduced in Spring Framework 7 (bundled with Spring Boot 4), covering the four built-in strategies: header, query parameter, media type parameter, and path segment. The demo builds a book search API, adds a new version to introduce a breaking change (searching by author/ISBN in addition to title), and shows how to configure fixed versions, baseline versions with semantic versioning rules, and custom version parsers for path segments. It also demonstrates testing versioned endpoints using MockMvcTester and RestTestClient, both new in Spring Framework 7/Spring Boot. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### What API versioning strategies does Spring Framework 7 support out of the box? Spring Framework 7, bundled with Spring Boot 4, provides four built-in API versioning strategies: header-based, query parameter-based, media type parameter-based, and path segment-based. Each strategy can be configured either through application properties or programmatically via a WebMvcConfigurer's configureApiVersioning method, and versions must follow semantic versioning (major.minor.patch). _Developers planning a Spring Boot 4 upgrade can browse hands-on breakdowns like this one on daily.dev._ ### How do I test versioned REST API endpoints in Spring Boot 4? Versioned endpoints can be tested with MockMvcTester or the newly introduced RestTestClient, both available with Spring Framework 7. Testing requires configuring an ApiVersionInserter matching the versioning strategy (header, query parameter, media type, or path segment) used in the application, then calling apiVersion() on the test client to specify which version to hit, or omitting it to use the default. _Engineers wiring up tests for versioned APIs can find practical examples like this through daily.dev._ ### What is baseline versioning in Spring Framework 7 and how does it differ from fixed versioning? Baseline versioning lets an endpoint serve a range of versions using a plus suffix, such as 1.0+, meaning it matches 1.0, 1.1, 1.2, and so on, as long as those versions are explicitly declared as supported. Fixed versioning instead binds an endpoint to one exact version number; requests for versions not in the supported list return no match even if they fall within the baseline range. _Teams designing backward-compatible APIs can dig into strategy comparisons like this via daily.dev._ ## Similar posts on daily.dev - [Spring Framework 7 API Versioning Explained](https://daily.dev/posts/spring-framework-7-api-versioning-explained-gau0lxh9y) · Foojay.io · 12 upvotes · 0 comments - [Spring Framework 7 and Spring Boot 4 Deliver API Versioning, Resilience, and Null-Safe Annotations](https://daily.dev/posts/spring-framework-7-and-spring-boot-4-deliver-api-versioning-resilience-and-null-safe-annotations-y4zbelfrx) · InfoQ · 19 upvotes · 0 comments - [How do you version public web APIs?](https://daily.dev/posts/how-do-you-version-public-web-apis--zhneb5v2o) · Lobsters · 2 upvotes · 0 comments - [Spring REST Docs 4.0.0](https://daily.dev/posts/spring-rest-docs-4-0-0-gyg0dfibr) · Spring · 3 upvotes · 0 comments - [The Spring Team on Spring Framework 7 and Spring Boot 4](https://daily.dev/posts/the-spring-team-on-spring-framework-7-and-spring-boot-4-ekyap8jua) · InfoQ · 8 upvotes · 0 comments --- Tags: [#java](https://daily.dev/tags/java), [#spring](https://daily.dev/tags/spring), [#rest-api](https://daily.dev/tags/rest-api), [#spring-boot](https://daily.dev/tags/spring-boot) [View this post on daily.dev](https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"All You Want to Know About Spring API Versioning","url":"https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe"},"datePublished":"2026-09-27T07:26:37.989Z","dateModified":"2026-09-27T07:53:27.197Z","description":"A walkthrough of the new API versioning feature introduced in Spring Framework 7 (bundled with Spring Boot 4), covering the four built-in strategies: header,...","image":"https://i.ytimg.com/vi/xDMjJuF4fDk/sddefault.jpg","thumbnailUrl":"https://i.ytimg.com/vi/xDMjJuF4fDk/sddefault.jpg","isAccessibleForFree":true,"articleSection":"SivaLabs (YouTube)","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"SivaLabs (YouTube)","logo":"https://media.daily.dev/image/upload/s--8ATVo4an--/f_auto,q_auto/v1790493987/logos/sivalabs-youtube?_a=BAMAMicg0","url":"https://daily.dev/sources/sivalabs-youtube"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"java,spring,rest-api,spring-boot","timeRequired":"PT25M","video":{"@type":"VideoObject","name":"All You Want to Know About Spring API Versioning","description":"A walkthrough of the new API versioning feature introduced in Spring Framework 7 (bundled with Spring Boot 4), covering the four built-in strategies: header,...","thumbnailUrl":"https://i.ytimg.com/vi/xDMjJuF4fDk/sddefault.jpg","uploadDate":"2026-09-27T07:26:37.989Z","duration":"PT25M","url":"https://api.daily.dev/r/dpwGIpoBE","embedUrl":"https://www.youtube.com/embed/xDMjJuF4fDk"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"SivaLabs (YouTube)","item":"https://daily.dev/sources/sivalabs-youtube"},{"@type":"ListItem","position":3,"name":"All You Want to Know About Spring API Versioning"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/all-you-want-to-know-about-spring-api-versioning-dpwgipobe#faq","mainEntity":[{"@type":"Question","name":"What API versioning strategies does Spring Framework 7 support out of the box?","acceptedAnswer":{"@type":"Answer","text":"Spring Framework 7, bundled with Spring Boot 4, provides four built-in API versioning strategies: header-based, query parameter-based, media type parameter-based, and path segment-based. Each strategy can be configured either through application properties or programmatically via a WebMvcConfigurer's configureApiVersioning method, and versions must follow semantic versioning (major.minor.patch). Developers planning a Spring Boot 4 upgrade can browse hands-on breakdowns like this one on daily.dev."}},{"@type":"Question","name":"How do I test versioned REST API endpoints in Spring Boot 4?","acceptedAnswer":{"@type":"Answer","text":"Versioned endpoints can be tested with MockMvcTester or the newly introduced RestTestClient, both available with Spring Framework 7. Testing requires configuring an ApiVersionInserter matching the versioning strategy (header, query parameter, media type, or path segment) used in the application, then calling apiVersion() on the test client to specify which version to hit, or omitting it to use the default. Engineers wiring up tests for versioned APIs can find practical examples like this through daily.dev."}},{"@type":"Question","name":"What is baseline versioning in Spring Framework 7 and how does it differ from fixed versioning?","acceptedAnswer":{"@type":"Answer","text":"Baseline versioning lets an endpoint serve a range of versions using a plus suffix, such as 1.0+, meaning it matches 1.0, 1.1, 1.2, and so on, as long as those versions are explicitly declared as supported. Fixed versioning instead binds an endpoint to one exact version number; requests for versions not in the supported list return no match even if they fall within the baseline range. Teams designing backward-compatible APIs can dig into strategy comparisons like this via daily.dev."}}]} ```