NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Gift Certificate Item → Get record

AI-generated

Summary

Retrieves a gift certificate item record by internal ID, optionally selecting fields, expanding subresources, or requesting asynchronous processing.

Inputs

  • id (required) — Internal identifier of the gift certificate item.
  • isDebugMode — Include full request and response information in the output.
  • expandSubResources — Automatically expand all sublists, sublist lines, and subrecords on this record.
  • fields — Comma‑separated list of field and sublist names to return; only these are included in the response.
  • Prefer — Server behavior request. Select "respond-async" to execute the request asynchronously. If used, the response will contain a job reference.
  • simpleEnumFormat — When set, enumeration values are returned as their internal ID only.
  • X-NetSuite-Idempotency-Key — Unique key for asynchronous requests to ensure a single execution; ignored for synchronous requests.

Output shape

A single record object representing the gift certificate item, optionally limited to selected fields or expanded subresources. If debug mode is enabled, the output additionally contains the raw request and response data.

If the Prefer header is set to "respond-async", the node returns a job reference instead of the full record, and the operation will complete in a subsequent run. All optional parameters are ignored if left empty.

Examples

Example 1: Retrieve a full gift certificate item record by ID

id: 123456; isDebugMode: false; expandSubResources: false; fields: ""; Prefer: ""; simpleEnumFormat: false; X-NetSuite-Idempotency-Key: ""

Example 2: Retrieve only selected fields from the record

id: 123456; fields: "name,price,description"; isDebugMode: false

Example 3: Request the record asynchronously with subresource expansion and idempotency key

id: 123456; expandSubResources: true; Prefer: "respond-async"; X-NetSuite-Idempotency-Key: "a6f2c4e8-3b9a-4d2a-a6e9-12b034f12345"; isDebugMode: false

Discussion