NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Inventory Item → Get record

AI-generated

Summary

Retrieve a specific Inventory Item record by its ID via NetSuite REST, optionally filtering fields, expanding subresources, or performing the call asynchronously.

Inputs

  • id (required) — Internal identifier of the Inventory Item.
  • expandSubResources — Set to true to automatically expand all sublists, sublist lines, and subrecords on this record.
  • fields — Comma‐separated list of field and sublist names to include in the response.
  • Prefer — Use 'respond-async' to execute the request asynchronously, causing the server to return a 202 status and a 'Preference-applied: respond-async' header.
  • simpleEnumFormat — Set to true to return enumeration values only as the internal ID.
  • X-NetSuite-Idempotency-Key — A UUID string that guarantees idempotent execution for asynchronous requests.
  • isDebugMode — Include full request and response objects in the node output for debugging.

Output shape

a single Inventory Item record returned as JSON (including subresources if requested); if isDebugMode is true, additional request/response objects are attached; if Prefer=respond-async, the output contains the asynchronous response metadata such as headers and status code rather than the full record.

When fetching a record synchronously, the node returns the full item record in the main output. When the Prefer header is set to 'respond-async', NetSuite responds with HTTP 202 and a Location header for polling; the node captures this metadata. The fields parameter limits which properties appear in the returned JSON. The expandSubResources flag causes all linked sublists and subrecords to be expanded inline in the result. The simpleEnumFormat flag changes the representation of enumeration fields to their internal ID values only.

Examples

Example 1: Simple inventory item fetch

Resource: Inventory Item, Operation: Get record, Id: 123456, expandSubResources: false, fields: '', Prefer: '', simpleEnumFormat: false, X-NetSuite-Idempotency-Key: ''

Example 2: Include only specific fields and expand subresources

Resource: Inventory Item, Operation: Get record, Id: 78910, expandSubResources: true, fields: 'name,price', Prefer: '', simpleEnumFormat: false, X-NetSuite-Idempotency-Key: ''

Example 3: Asynchronous request with idempotency key

Resource: Inventory Item, Operation: Get record, Id: 112233, Prefer: respond-async, X-NetSuite-Idempotency-Key: '550e8400-e29b-41d4-a716-446655440000', expandSubResources: false, fields: '', simpleEnumFormat: false

Discussion