curl --request GET \
--url https://{cluster}.voucherify.io/v2/loyalties/earning-rules \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>'{
"data": [
{
"id": "lern_133a941c44c06594cf",
"name": "Updated earning rule",
"status": "ACTIVE",
"earnings": [
{
"id": "lernei_1351c417a0e179f2f0",
"name": "New earning rule 02",
"tier_rules": {
"type": "NO_REQUIREMENTS"
},
"effects": [
{
"type": "POINTS",
"points": {
"value": 100,
"card_definition_id": "lcdef_1331564fab0b1ce713"
}
}
]
}
],
"trigger": {
"event": "customer.order.paid"
},
"validity_hours": {
"type": "ANY_TIME"
},
"start_date": null,
"end_date": "2026-12-31T00:00:00.000Z",
"trigger_limits": {
"cooldown": {
"type": "NO_COOLDOWN"
},
"frequency": {
"type": "NO_LIMIT",
"limits": []
}
},
"earning_limits": {
"global": {
"type": "NO_LIMIT",
"limits": []
}
},
"metadata": {
"some-value": null,
"temporary_earning_rule": true
},
"created_at": "2026-10-22T11:30:54.857Z",
"updated_at": "2026-11-09T11:45:39.728Z",
"object": "earning_rule"
},
{
"id": "lern_133a93007e0a5d2c4d",
"name": "Earning rule 2026-10-22-04",
"status": "DRAFT",
"earnings": [
{
"id": "lernei_133a93007cca5d2c4c",
"tier_rules": {
"type": "NO_REQUIREMENTS"
},
"effects": [
{
"type": "POINTS",
"points": {
"value": 150,
"card_definition_id": "lcdef_1329efb2af8ba6486f"
}
}
]
}
],
"trigger": {
"event": "customer.order.paid"
},
"error": {
"message": "You don't know what's right!"
},
"validity_hours": {
"type": "DAILY",
"daily": [
{
"days_of_week": [
0,
5,
6
],
"start_time": "15:00",
"end_time": "17:30"
}
]
},
"start_date": null,
"end_date": null,
"trigger_limits": {
"cooldown": {
"type": "FIXED_COOLDOWN",
"fixed_cooldown": {
"period": {
"value": 1,
"unit": "HOUR"
}
}
},
"frequency": {
"type": "LIMITED",
"limits": [
{
"type": "TIME_BASED",
"period": {
"type": "CURRENT_PERIOD",
"current_period": {
"unit": "WEEK"
}
},
"triggers": {
"max": 2
}
}
]
}
},
"earning_limits": {
"global": {
"type": "NO_LIMIT",
"limits": []
}
},
"metadata": {},
"created_at": "2026-10-22T11:26:04.277Z",
"updated_at": null,
"object": "earning_rule"
}
],
"cursor": {
"next": "lcrsern_135ae8db62c5c29be2",
"expires_at": "2026-11-16T14:22:34.315Z"
},
"object": "list"
}List earning rules
Returns a cursor-paginated list of earning rules. Rules with status DELETED are excluded. The same field cannot be used
in both ascending and descending order at once
(e.g. order=name&order=-name is rejected). Default order is -created_at;
id is always appended as a tie-breaker.
A successful call records no activity.
curl --request GET \
--url https://{cluster}.voucherify.io/v2/loyalties/earning-rules \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>'{
"data": [
{
"id": "lern_133a941c44c06594cf",
"name": "Updated earning rule",
"status": "ACTIVE",
"earnings": [
{
"id": "lernei_1351c417a0e179f2f0",
"name": "New earning rule 02",
"tier_rules": {
"type": "NO_REQUIREMENTS"
},
"effects": [
{
"type": "POINTS",
"points": {
"value": 100,
"card_definition_id": "lcdef_1331564fab0b1ce713"
}
}
]
}
],
"trigger": {
"event": "customer.order.paid"
},
"validity_hours": {
"type": "ANY_TIME"
},
"start_date": null,
"end_date": "2026-12-31T00:00:00.000Z",
"trigger_limits": {
"cooldown": {
"type": "NO_COOLDOWN"
},
"frequency": {
"type": "NO_LIMIT",
"limits": []
}
},
"earning_limits": {
"global": {
"type": "NO_LIMIT",
"limits": []
}
},
"metadata": {
"some-value": null,
"temporary_earning_rule": true
},
"created_at": "2026-10-22T11:30:54.857Z",
"updated_at": "2026-11-09T11:45:39.728Z",
"object": "earning_rule"
},
{
"id": "lern_133a93007e0a5d2c4d",
"name": "Earning rule 2026-10-22-04",
"status": "DRAFT",
"earnings": [
{
"id": "lernei_133a93007cca5d2c4c",
"tier_rules": {
"type": "NO_REQUIREMENTS"
},
"effects": [
{
"type": "POINTS",
"points": {
"value": 150,
"card_definition_id": "lcdef_1329efb2af8ba6486f"
}
}
]
}
],
"trigger": {
"event": "customer.order.paid"
},
"error": {
"message": "You don't know what's right!"
},
"validity_hours": {
"type": "DAILY",
"daily": [
{
"days_of_week": [
0,
5,
6
],
"start_time": "15:00",
"end_time": "17:30"
}
]
},
"start_date": null,
"end_date": null,
"trigger_limits": {
"cooldown": {
"type": "FIXED_COOLDOWN",
"fixed_cooldown": {
"period": {
"value": 1,
"unit": "HOUR"
}
}
},
"frequency": {
"type": "LIMITED",
"limits": [
{
"type": "TIME_BASED",
"period": {
"type": "CURRENT_PERIOD",
"current_period": {
"unit": "WEEK"
}
},
"triggers": {
"max": 2
}
}
]
}
},
"earning_limits": {
"global": {
"type": "NO_LIMIT",
"limits": []
}
},
"metadata": {},
"created_at": "2026-10-22T11:26:04.277Z",
"updated_at": null,
"object": "earning_rule"
}
],
"cursor": {
"next": "lcrsern_135ae8db62c5c29be2",
"expires_at": "2026-11-16T14:22:34.315Z"
},
"object": "list"
}Authorizations
Query Parameters
Orders the results. Accepts one value or an array. Prefix a field with - for descending order. Allowed values: -created_at, created_at, name, -name. 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.
-created_at, created_at, name, -name Continues pagination. Pass the cursor.next value from a previous response. Format lcrsern_[a-f0-9]+. The cursor matches the filters and order of that response. Cursors expire. An expired cursor returns 400 (invalid_or_expired_cursor). Changing filters or order between pages returns 400 (cursor_and_query_mismatch).
^lcrsern_[a-f0-9]+$Filters the results by id, name, status, or created_at. Pass a deep object, for example filters[status][conditions][$is]=ACTIVE. Fields combine through junction, which defaults to AND. Omit filters to apply no field filter.
Request query schema for GET /v2/loyalties/earning-rules.
Show child attributes
Show child attributes
Response
Paginated list of earning rules

