NetSuite Versioning and WSDL Versioning Overview
The naming convention for NetSuite versions and WSDL versions are the same. For example, for 2025.1, there is an accompanying 2025_1 version of the WSDL, as shown in the following WSDL URLs:
https://webservices.netsuite.com/wsdl/v2025_1_0/netsuite.wsdl
https://content.netsuite.com/download/WSDL_v2025_1_0.zip
NetSuite WSDL versioning denotes:
-
the major version: v2025_1
-
the minor or patch version: _0
Typically, a new NetSuite release includes a WSDL version that supports the latest features and enhancements. For instance, when new workflows or records are added to NetSuite, the corresponding WSDL usually includes new operations or records to match these enhancements. In some releases, a new WSDL also includes enhancements to the SOAP web services platform itself. These enhancements are independent of NetSuite product enhancements.
Note that upgrading your NetSuite account doesn't necessarily mean you need to upgrade your WSDL version. For instance, you can continue using the 2024.1 WSDL with a NetSuite account that's been upgraded to 2025.1. For more information, see Upgrading WSDL Versions.
When a new NetSuite release and WSDL version are available, review the relevant sections of the Sneak Peeks and Release Notes. These documents list all of the new functionality and any schema bug fixes offered in the latest WSDL.