{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Versioning","siteUrl":"https://docs.wise.com","projectTitle":"Wise Platform","description":"Wise Platform offer domestic and cross-border payments tools for technology platforms, banks and fininical institutions.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"versioning","__idx":0},"children":["Versioning"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform APIs evolve over time as we add features and expand coverage. This guide explains how Wise Platform versions its APIs, what types of changes you can expect within a version, and how to choose which version to use."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Versioning scope"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This versioning policy does not currently apply to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["webhooks"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sensitive card details"]}," endpoints. We will update this policy once these endpoints have been migrated to this versioning scheme."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-versioning-works-at-wise-platform","__idx":1},"children":["How versioning works at Wise Platform"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform uses global, calendar-based versioning (CalVer). Versions are shared across the API (rather than versioning each endpoint independently) and released on a quarterly basis."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Versions are named by year and quarter, for example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026Q3"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026Q4"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform versioning is URL-based, meaning you select a version by including it in the endpoint request path."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/2026Q3/auth/jose/response/public-keys"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"version-types","__idx":2},"children":["Version types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform makes the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Active"]}," versions of the API available for production and publishes documentation for these versions in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version type"},"children":["Version type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Latest"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The generally available (GA) version that is recommended for production."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No breaking changes introduced within a ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["May still receive non-breaking updates, such as: new optional response fields, request parameters, endpoints/resources."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prior released versions with continuous support until they are sunset (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#deprecation-and-sunset-policy"},"children":["Deprecation and sunset policy"]}," for details)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"release-cadence","__idx":3},"children":["Release cadence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform versions are released ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["quarterly"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each quarter, the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version updates to the the next version in the sequence. For example, on 1 October 2026 the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version will move from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026Q3"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026Q4"]},". This new ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version will include any major and breaking changes added to the API, which will be documented in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/changelog"},"children":["changelog"]}," along with any necesary migration guidance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026Q3"]}," version remains an active, supported version."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"changes","__idx":4},"children":["Changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise classifies changes as either breaking or non-breaking."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"breaking-changes","__idx":5},"children":["Breaking changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A breaking change is any change that requires you to modify your integration to keep it working as originally intended."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Removing or renaming a field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Changing a field’s type or meaning."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Introducing new required parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Removing or fundamentally changing an endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Behavioural changes that alter expected outcomes for the same request."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Breaking changes require updating your request URLs to that version and are only introduced when the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version is updated at the start of each quarter."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"non-breaking-changes","__idx":6},"children":["Non-breaking changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise may introduce additive, backward-compatible changes within the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Latest"]}," version at any time. These changes will ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["not"]}," increment the API version number."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding new fields to responses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding new optional request parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding new endpoints/resources."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Integration best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Design to be resilient to additive changes so that newly-added fields do not break parsing or validation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deprecation-and-sunset-policy","__idx":7},"children":["Deprecation and sunset policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise supports each active version until such time as we determine it needs to be deprecated."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this time, there is no set time frame for how long a version will remain active. However, we have no plans right now to sunset any currently supported versions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To avoid disruption to your integration, any plans to sunset versions will be communicated well in advance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"communication-policy","__idx":8},"children":["Communication policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ahead of sunsetting a version, Wise will provide notice at least 6 months in advance via:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email to partner contacts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.wise.com/changelog"},"children":["developer changelog"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"policy-review","__idx":9},"children":["Policy review"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise Platform is continuously evolving as we offer new features and coverage to our API customers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It's important to us that our partner integrations are not adversely affected by changes and we endeavor to uphold these standards as part of our company's mission of transparency. We are regularly reviewing our policies to make sure we're delivering the best possible developer experience."]}]},"headings":[{"value":"Versioning","id":"versioning","depth":1},{"value":"How versioning works at Wise Platform","id":"how-versioning-works-at-wise-platform","depth":2},{"value":"Version types","id":"version-types","depth":2},{"value":"Release cadence","id":"release-cadence","depth":2},{"value":"Changes","id":"changes","depth":2},{"value":"Breaking changes","id":"breaking-changes","depth":3},{"value":"Non-breaking changes","id":"non-breaking-changes","depth":3},{"value":"Deprecation and sunset policy","id":"deprecation-and-sunset-policy","depth":2},{"value":"Communication policy","id":"communication-policy","depth":3},{"value":"Policy review","id":"policy-review","depth":2}],"frontmatter":{"markdown":{"toc":{"depth":3}},"seo":{"title":"Versioning"}},"lastModified":"2026-06-24T12:39:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/developer/global-versioning","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}