Dynamic Discovery of URLs for SOAP Web Services and RESTlet Clients

NetSuite accounts are sometimes moved from one data center to another to achieve optimal cloud resource utilization. In the past, the URLs used to access NetSuite were data center-specific, meaning they had to be changed after an account was moved to a different data center. In your NetSuite account, you should avoid using data center-specific URLs. You should use your account-specific URLs. Account-specific URLs to do not need to be updated after an account is moved o a different data center.

Do not attempt to construct an account-specific domain yourself. Each account (production, Release Preview, and sandbox) has a unique account-specific domain. The account-specific URLs for all services are shown on the Company URLs subtab of the Company Information page of your production, Release Preview, and sandbox accounts. In cases where an application accesses more than one NetSuite account, you can use dynamic discovery methods to obtain the correct URLs. See URLs for Account-Specific Domains for more information.

An external client that sends requests to a NetSuite account must use the correct domain name for that account. That is, a SOAP web services request sent to a NetSuite account must be sent to the correct web services domain for that account. A request to a RESTlet must be sent to a URL that includes the correct RESTlet domain for the account where the RESTlet is deployed. The following alternatives are designed for these use cases. These alternatives can be used in production, sandbox, and Release Preview accounts.


Do not use any form of certificate pinning (for example, HPKP headers) on any NetSuite service. NetSuite certificates can change at any time and without notice. If you pin a NetSuite certificate, access to NetSuite can be denied after a certificate is changed.

Related Topics

NetSuite Accounts in a Cloud Environment
Supported TLS Protocol and Cipher Suites
Secure HTTPS Outbound Communication and SSL Certificates
VPN Configuration for User Access to NetSuite
Traffic Health
NetSuite Accounts Are Hosted in the Cloud
Best Practices for NetSuite Access by Feature
Understanding NetSuite URLs
URLs for Account-Specific Domains
How to Transition from Data Center-Specific Domains
DataCenterUrls REST Service
The REST Roles Service

General Notices