Earning Rules

List earning rule activities

Changed on
<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact Voucherify support or your Technical Account Manager.

</Info>

Returns a cursor-paginated list of activities (audit trail) for a single earning rule. The same field cannot be used in both ascending and descending order at once. Default order is -created_at.

get/v2/loyalties/earning-rules/{earningRuleId}/activities

Request

  • Base URL
    https://api.voucherify.io
  • URL
    https://api.voucherify.io/v2/loyalties/earning-rules/{earningRuleId}/activities
  • Auth
    • API key in header X-App-Id and API key in header X-App-Token
    • or HTTP bearer

Query parameters

number
OR
string

Limits the page size to an integer from 1 to 100. Defaults to 10. A numeric string is accepted and rounded to the nearest integer.

'created_at' | '-created_at'
OR
string[]

Orders the results. Accepts one value or an array. Prefix a field with - for descending order. Defaults to -created_at. The same field cannot be used in both directions. Rows with the same sort value are then ordered by id ascending.

cursorstring nullable

Continues pagination. Pass the cursor.next value from a previous response. Format lcrsaer_[a-f0-9]+. The cursor matches the filters and order of that response.

junction'AND' | 'OR' nullable

Joins the field filters. Allowed values are AND and OR. Defaults to AND.

Filters the results. Pass a deep object, for example filters[type][conditions][$is]=vl.earning_rule.updated. Fields combine through junction, which defaults to AND. Omit filters to apply no field filter.

Response

Paginated list of earning rule activities

object'list'

Object type marker. Always list.

Changes

  • v2ec801ade260dRevision changes
    • breaking

      for the query request parameter limit, the type changed from integer to number string null

    • warning

      deleted the path request parameter earningRuleId

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      query request parameter order list-of-types was widened by adding types null

    • info

      for the query request parameter filters, the type was generalized from object to no type

    • info

      added to the response body allOf list for the response status

    • info

      removed the non-success response with the status

  • v2f95b50556c93Revision changes
    • breaking

      added the new path request parameter earningRuleId

    • breaking

      query request parameter order list-of-types was narrowed by removing types null

    • breaking

      for the query request parameter filters, the type changed from no type to object

    • breaking

      for the query request parameter limit, the type changed from number string null to integer

    • info

      removed from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status