SCscalev
Discounts

List discount codes

Business-scoped discount-code list ordered by discount-code ID descending. Supports code search plus applied_to and enabled-status filters. Results use v3 cursor pagination.

get/v3/discount-codes

Request

  • Base URL
    https://api.scalev.com
  • URL
    https://api.scalev.com/v3/discount-codes
  • Auth
    • HTTP bearer
    • or API key in header authorization
    • or OAuth 2
      Authorization code: https://api.scalev.com/v3/oauth/authorize
      Token URL: https://api.scalev.com/v3/oauth/token scopes: discount_code:list

Query parameters

page_sizeinteger

Cursor page size.

next_cursorstring

Opaque cursor for the next page.

previous_cursorstring

Opaque cursor for the previous page.

searchstring

Case-insensitive partial match against the discount code.

applied_to'product_price' | 'shipping_cost'

Filter by the value the discount applies to.

status'enabled' | 'disabled'

Filter by whether customers can use the discount code.

Response

Paginated discount-code list

is_paginatedtrue required
has_nextboolean
has_previousboolean
next_cursorstring nullable
previous_cursorstring nullable
page_sizeinteger

Changes

No recorded changes to this operation across all 14 revisions of this API.