Dynamic URL Discovery for SOAP Web Services

When sending requests to a NetSuite account, an external client needs to use the account's correct domain name. For example, a SOAP web services request must be sent to the account's correct web services domain.

You can use the SOAP web services operation getDataCenterUrls to achieve this. Send the getDataCenterUrls request to webservices.netsuite.com, the NetSuite web services dynamic discovery domain: webservices.netsuite.com. The getDataCenterURLs operation helps you retrieve the correct SOAP web services domain name for a specified NetSuite account. You can use this operation in production, sandbox, and Release Preview accounts.

Important:

The dynamic discovery service is upgraded early and independently of your account, so getDataCenterUrls may be processed with the new WSDL version, even though the target account hasn't been upgraded yet. If your integration uses an older endpoint like 2018_2 and is negatively impacted, use one of the following alternatives:

  • Use one of the supported endpoints for the NetSuite 2025.2 release on all SOAP calls, ideally the 2025_1 endpoint.

  • Instead of dynamic discovery getDataCenterUrls requests use the Account Specific Endpoint (Setup > Company > Company Information > Company URLs | SuiteTalk SOAP URL) to target all SOAP calls. This way it is still possible to use https://<accountID>.suitetalk.api.netsuite.com/services/NetSuitePort_2018_2, if your own account is on the 2025.1 version.

  • Append the URL parameter NS_VER=2025.1 on your endpoint URL for your initial dynamic discovery getDataCenterUrls request (https://webservices.NetSuite.com/services/NetSuitePort_2018_2?NS_VER=2025.1). This will force routing for this initial request to system endpoint where it will not fail.

Related Topics

General Notices