NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Contact Role → Get list of records

AI-generated

Summary

Retrieve a list of NetSuite contact roles, optionally paginated, filtered, or processed asynchronously.

Inputs

  • Debug Mode — Whether to include full request and response info in the output.
  • Limit — The limit used to specify the number of results on a single page.
  • Offset — The offset used for selecting a specific page of results.
  • Prefer — The server behavior requested by the client. Use respond‑async to execute the request asynchronously. If asynchronous, a Preference‑applied: respond‑async header will be returned.
  • Q — The search query that is used to filter results.
  • X‑NetSuite‑Idempotency‑Key — A user‑defined unique idempotency key applied to every asynchronous request to ensure it is executed only once. For synchronous requests this field is ignored.

Output shape

a list of Contact Role records, each containing the fields returned by NetSuite for a contact role

The list is paginated; use Limit and Offset to control pagination. When Debug Mode is enabled, each item includes the raw NetSuite request and response JSON. For asynchronous requests (Prefer: respond‑async) the node returns immediately with a status header; the full result is available only later – error handling may be required.

Examples

Example 1: Retrieve all contact roles with default pagination

Leave Limit, Offset, Prefer, Q, and X‑NetSuite‑Idempotency‑Key empty; Debug Mode off.

Example 2: Retrieve the first 20 contact roles

Set Limit to 20; leave other fields empty; Debug Mode off.

Example 3: Search for contact roles containing 'Manager' and use async processing

Set Q to 'Manager', Prefer to 'respond‑async', leave Limit/Offset empty; Debug Mode off.

Discussion