Acumatica API - Endpoint Default 23 200 001 icon

Acumatica API - Endpoint Default 23 200 001

Interact with Acumatica Endpoint Default/23.200.001

Actions478

Discount → Get List

AI-generated

Summary

Retrieve Discount records from Acumatica, applying optional OData-based filters defined via the node's UI parameters.

Inputs

  • ActiveFilter — Filter results by Active status. Uses operator 'Equals' against a boolean value.
  • BreakByFilter — Filter results by Break By field. Supports Equals, Contains, or Starts With operators against a string value.
  • CreatedDateTimeFilter — Filter results by Created Date Time. Supports Equals, After (gt), On or After (ge), Before (lt), On or Before (le) operators against a dateTime value.
  • DescriptionFilter — Filter results by Description. Supports Equals, Contains, or Starts With operators against a string value.
  • DiscountByFilter — Filter results by Discount By. Supports Equals, Contains, or Starts With operators against a string value.
  • DiscountCodeFilter — Filter results by Discount Code. Supports Equals, Contains, or Starts With operators against a string value.
  • EffectiveDateFilter — Filter results by Effective Date. Supports Equals, After (gt), On or After (ge), Before (lt), On or Before (le) operators against a dateTime value.
  • ExpirationDateFilter — Filter results by Expiration Date. Supports Equals, After (gt), On or After (ge), Before (lt), On or Before (le) operators against a dateTime value.
  • LastModifiedDateTimeFilter — Filter results by Last Modified Date Time. Supports Equals, After (gt), On or After (ge), Before (lt), On or Before (le) operators against a dateTime value.
  • PromotionalFilter — Filter results by Promotional flag. Uses Equals operator against a boolean value.
  • ProrateDiscountFilter — Filter results by Prorate Discount flag. Uses Equals operator against a boolean value.
  • SequenceFilter — Filter results by Sequence. Supports Equals, Contains, or Starts With operators against a string value.
  • ShowFreeItemFilter — Filter results by Show Free Item flag. Uses Equals operator against a boolean value.
  • customFilter — Advanced OData $filter expression (e.g. 'DiscountCode/value eq 'DISCOUNT001''). Applied in addition to any filter fields above.

Output shape

Array of Discount objects matching the applied filters. Returns an empty array if no records match the criteria.

The node builds an OData $filter query string from the selected filter parameters and optional custom filter, appends it to the resource endpoint URL, and fetches the result set. Default/empty filter values are stripped before request to avoid 400 errors from the Acumatica API.

Examples

Example 1: Retrieve all active discounts

Set ActiveFilter operator to Equals and value to true.

Example 2: Retrieve discounts expiring after a specific date

Set ExpirationDateFilter operator to gt and provide a dateTime value.

Links

Discussion