1. SuiteCloud Platform
  2. SuiteTalk Web Services
  3. SuiteTalk SOAP Web Services Platform Guide
  4. SuiteTalk SOAP Web Services Platform Overview
  5. NetSuite WSDL Versioning
  6. NetSuite Versioning and WSDL Versioning Overview

NetSuite Versioning and WSDL Versioning Overview

Important:

Oracle NetSuite has scheduled the gradual removal of SOAP web services from the product as part of ongoing efforts to provide modern integration channels.

The 2025.2 SOAP endpoint is the last planned SOAP endpoint and any later SOAP endpoints would be released only as necessary to meet business, technical, or other significant requirements.

The support period of older endpoints is also affected and with the 2027.1 release, only the 2025.2 endpoint will be supported. With the 2028.2 release, SOAP will no longer be available in NetSuite and existing SOAP integrations with NetSuite will stop working.

For more details, see the Removal of SOAP Web Services and the SOAP Removal Plans FAQ. For a list of the currently supported endpoints, see Support for Existing WSDL Versions.

SuiteTalk REST web services is the technology intended to replace SOAP. All newly built integrations should use REST web services with OAuth 2.0 for authentication.

  • For any custom integration applications, that you have developed using SOAP, you should start planning the migration of your solution to REST as soon as possible. For a detailed guide for the migration, see SOAP Web Services To Rest Web Services Upgrade Guide.

  • If you use a partner SOAP application to integrate with NetSuite, consult with your partner to provide you with a REST-based application instead.

  • If you use an Oracle NetSuite integration application, a REST-based application will be provided by Oracle NetSuite.

The naming convention for NetSuite versions and WSDL versions are the same. For example, for 2025.2, there is an accompanying 2025_2 version of the WSDL, as shown in the following WSDL URLs:

https://webservices.netsuite.com/wsdl/v2025_2_0/netsuite.wsdl

https://content.netsuite.com/download/WSDL_v2025_2_0.zip

NetSuite WSDL versioning denotes:

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 2025.1 WSDL with a NetSuite account that's been upgraded to 2025.2. 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.

Related Topics

General Notices