You can only access REST web services using account-specific domains. Account-specific domains are unique to your account because they contain your account ID as part of the domain name. These domains do not change when your account is moved to a different data center.
When using account-specific domains, dynamic domain discovery is not needed.
The format of an account-specific domain name is the following: <account ID>.<service>.netsuite.com. For example, if your account ID is 123456, your account-specific domain for REST web services is: 123456.suitetalk.api.netsuite.com
You can find the service URL for SuiteTalk (SOAP and REST web services) at Setup > Company > Setup Tasks > Company Information, on the Company URLs subtab. When you build a client application, you must ensure that the service URL is a configurable parameter.
The examples in this document use demo123 as the account ID. Substitute this with your own account ID.
You can access NetSuite resources through REST web services by using URLs specific to either record or query service.
A URL for a REST resource looks like the following.
The URL consists of the following parts:
The account ID of your NetSuite account
The domain name for REST web services
The complete REST API services endpoint
The specific services that is being accessed, for example, record, query, or other service
The service version, which specific to each service
The optional sub-service, for example,
The following examples demonstrate the usage of the record and query services.
To use CRUD operations on records, you can use a URL similar to the following:
For information about CRUD operations, see Working with Records.
Metadata-catalog is a subservice of the record service. To access resource metadata, you can use a URL similar to the following:
For information about using metadata, see Working with Resource Metadata.
dataset is a subservice of the query service. To execute saved datasets, you can use a URL similar to the following:
For information about saved datasets, see Working with SuiteAnalytics Datasets in REST Web Services.
Suiteql is a subservice of the query service. To execute SuiteQL queries, you can use a URL similar to the following:
For information about SuiteQL queries in REST web services, see Executing SuiteQL Queries Through REST Web Services.