Pick the List Achievements action (under management).
Fill in the fields below, then reference the result from later steps as {{listAchievements.response.data}}.
Request
Path parameters
applicationIdinteger (int64)required
The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignIdinteger (int64)required
The ID of the campaign. It is displayed in your Talon.One deployment URL.
Query parameters
pageSizeinteger (int64)
The number of items in the response.
Default 50
skipinteger (int64)
The number of items to skip when paging through large result sets.
titlestring
Filter by the display name for the achievement in the campaign manager.
**Note**: If no `title` is provided, all the achievements from the campaign are returned.
Response
Returns 200 with an object. Read it in later steps with {{listAchievements.response.data.<field>}}.
hasMoreboolean
dataarray<object>
idinteger (int64)required
The internal ID of this entity.
createdstring (date-time)required
The time this entity was created.
namestringrequired
The internal name of the achievement used in API requests.
**Note**: The name should start with a letter. This cannot be changed after the achievement has been created.
titlestringrequired
The display name for the achievement in the Campaign Manager.
descriptionstring (string)required
A description of the achievement.
targetnumberrequired
The required number of actions or the transactional milestone to complete the achievement.
periodstring
The relative duration after which the achievement ends and resets for a particular customer profile.
**Note**: The `period` does not start when the achievement is created.
The period is a **positive real number** followed by one letter indicating the time unit.
Examples: `30s`, `40m`, `1h`, `5D`, `7W`, `10M`, `15Y`.
Available units:
- `s`: seconds
- `m`: minutes
- `h`: hours
- `D`: days
- `W`: weeks
- `M`: months
- `Y`: years
You can also round certain units down to the beginning of period and up to the end of period.:
- `_D` for rounding down days only. Signifies the start of the day.
Example: `30D_D`
- `_U` for rounding up days, weeks, months and years. Signifies the end of the day, week, month or year.
Example: `23W_U`
**Note**: You can either use the round down and round up option or set an absolute period.
periodEndOverrideobject6 fields
The absolute duration after which the achievement ends and resets for a particular customer profile.
**Note**: The duration follows the time zone of the Application this achievement belongs to.
recurrencePolicystring
The policy that determines if and how the achievement recurs.
- `no_recurrence`: The achievement can be completed only once.
- `on_expiration`: The achievement resets after it expires and becomes available again.
- `on_completion`: When the customer progress status reaches `completed`, the achievement resets and becomes available again.
One ofno_recurrenceon_expirationon_completion
activationPolicystring
The policy that determines how the achievement starts, ends, or resets.
- `user_action`: The achievement ends or resets relative to when the customer started the achievement.
- `fixed_schedule`: The achievement starts, ends, or resets for all customers following a fixed schedule.
One ofuser_actionfixed_schedule
fixedStartDatestring (date-time)
The achievement's start date when `activationPolicy` is set to `fixed_schedule`.
**Note:** It must be an RFC3339 timestamp string.
endDatestring (date-time)
The achievement's end date. If defined, customers cannot participate in the achievement after this date.
**Note:** It must be an RFC3339 timestamp string.
allowRollbackAfterCompletionboolean
When `true`, customer progress can be rolled back in completed achievements.
campaignIdinteger (int64)required
The ID of the campaign the achievement belongs to.
userIdinteger (int64)required
ID of the user that created this achievement.
createdBystring
Name of the user that created the achievement.
**Note**: This is not available if the user has been deleted.
hasProgressboolean
Indicates if a customer has made progress in the achievement.
statusstring
The status of the achievement.
One ofinprogressexpirednot_startedcompleted
json
{"data":[{"period":"1Y","endDate":{},"created":{},"campaignId":1,"description":"50% off for every 50th purchase in a year.","activationPolicy":"fixed_schedule","title":"50% off on 50th purchase.","allowRollbackAfterCompletion":false,"userId":1234,"hasProgress":true,"target":50,"fixedStartDate":{},"createdBy":"John Doe","name":"Order50Discount","periodEndOverride":{"month":11,"dayOfMonth":23,"hour":23,"minute":59,"second":59},"id":6,"recurrencePolicy":"no_recurrence","status":"inprogress"}],"hasMore":false}
Need more? See the Talon.One guide for connection setup and behaviour shared by every action.
