NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Inventory Item → Get list of records

AI-generated

Summary

Retrieve a list of Inventory Item records from NetSuite, optionally paging, filtering, and including debug information.

Inputs

  • isDebugMode — Include complete request and response details in the output when set to true.
  • limit — Maximum number of items returned in a single page.
  • offset — Starting point for the returned page of items.
  • Prefer — Request server behavior; select "respond-async" to execute the request asynchronously, which modifies the response headers and requires an idempotency key.
  • q — Search query string to filter Inventory Item records.
  • X-NetSuite-Idempotency-Key — Unique UUID used only when the request is asynchronous to ensure idempotence.

Output shape

a list of Inventory Item records; when debug mode is enabled, each item includes request and response metadata

NetSuite applies pagination based on provided limit and offset. If "Prefer" is set to "respond-async", the body may be empty and a 202 status with a "Preference-applied: respond-async" header is returned; the idempotency key is required for such requests. If debug mode is true, the output contains full HTTP request and response information in addition to the data.

Examples

Example 1: Retrieve the first 20 inventory items.

Set limit to 20; leave offset empty; no debug mode.

Example 2: Get the third page of inventory items, 10 per page.

Set limit to 10 and offset to 20 (first two pages already skipped).

Discussion