Subsidiary
NetSuite exposes the subsidiary record to REST web services. The subsidiary record enables you to manage data for a hierarchical structure of separate legal entities. See Subsidiaries in OneWorld.
REST web services do not support legacy tax features. To work with taxation through REST web services, you must have the SuiteTax feature enabled. For more information about using SuiteTax, see SuiteTax.
The REST API Browser includes information about the field names and field types of the subsidiary record. It also includes the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s subsidiary reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for the subsidiary REST record is subsidiary.
The record IDs for the subsidiary REST subrecords are:
-
mainaddress
-
shippingaddress
-
returnaddress
Prerequisites
You must either use NetSuite OneWorld or have the Subsidiaries hidden feature enabled before you can use this record through REST web services.
Exposed Elements
The following subsidiary record elements are exposed to REST web services:
-
(internalid) - internal id
-
(externalid) - external id
-
(isinactive) - subsidiary is inactive
-
(legalname) - legal name
-
(name) - name
-
(fullname) - (search-only field)
-
(parent) - subsubsidiary of
-
(currency) - currency
-
(iselimination) - elimination
-
(country) - country
-
(state) - state/province
-
(url) - web site
-
(email) - return email address
-
(fax) - fax
The following subsidiary subrecord elements are exposed to REST web services:
-
(mainaddress) - main address
-
(shippingaddress) - shipping address
-
(returnaddress) - return address
Limitations
Only GET (Read, Search) operation is supported for REST web services. POST (create), PATCH (update), and DELETE are not supported. Tax-related fields are not supported in REST.
Code Samples
The following code samples show a common use case for getting supported elements from the subsidiary REST record.
{GET /services/rest/record/v1/subsidiary/<id>}
{GET /services/rest/record/v1/subsidiary?q=fullName CONTAIN "parent"}