NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Coupon Code → Get list of records

AI-generated

Summary

Retrieve a list of Coupon Code records from NetSuite, optionally filtering, paginating, and configuring async handling.

Inputs

  • isDebugMode — Include full request and response data in the output if true.
  • limit — Maximum number of records to return in a single page.
  • offset — Starting index for the page of results.
  • Prefer — Server behaviour – set to "respond-async" to execute the request asynchronously.
  • q — Search query string to filter Coupon Code records.
  • X-NetSuite-Idempotency-Key — Unique UUID key ensuring an asynchronous request is executed only once.

Output shape

A list of Coupon Code records (array). If Debug Mode is enabled, each item contains a debug object with request and response details.

Results are paginated according to Limit and Offset. When Prefer is set to "respond-async", NetSuite returns a Preference‑applied header; the operation still supplies the same array of records if the async operation completes successfully.

Examples

Example 1: Basic listing

Select 'Coupon Code' → 'Get list of records', leave optional fields empty to return the first page of coupons.

Example 2: Paginated results

Set Limit=10 and Offset=20 to fetch the third page (items 21–30) of Coupon Code records.

Example 3: Asynchronous search

Set Q='discount', Prefer='respond-async', and provide a UUID for X-NetSuite-Idempotency-Key to perform an async filtered search that will only run once.

Discussion