learndash/list-achievements lists the achievement definitions on this site — the badges learners can earn.
Requires the LearnDash Achievements add-on.
At a glance
| Ability | learndash/list-achievements |
| Toolset | LearnDash — toolset/learndash |
| Group | LearnDash › Achievements |
| Requires | AcrossAI Pro, plus LearnDash LMS active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
Each definition carries its trigger, which is what a learner does to earn it; its points; its occurrence limit; its scope; and how many times it has actually been awarded.
The award count is the most informative column. An achievement defined a year ago and never awarded is either scoped to something nobody does, or triggered by something that does not fire — and both look identical from the definition.
The occurrence limit decides whether a badge is repeatable. Zero means unlimited, which is what makes “logged in five days running” a badge somebody can earn repeatedly.
Scope keys restrict a badge to a particular course, lesson, topic, quiz or group. The string all is a wildcard and an empty key means not applicable to that trigger — which are different things and easy to conflate.
learndash/list-achievement-triggers lists the valid trigger keys, read live because the list is extensible.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
achievements | array | Each badge with its trigger, points, occurrence limit, scope and award count. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
What badges can learners earn here?
It resolves to one call:
{
"ability": "learndash/list-achievements",
"parameters": {}
}Worth knowing
- A zero award count usually means the scope or trigger is wrong.
- An occurrence limit of zero means unlimited repeats.
- Scope
allis a wildcard; an empty scope means not applicable. - Requires the LearnDash Achievements add-on.
Related abilities
- LearnDash Get Achievement — one badge in detail
- LearnDash List Triggers — the valid trigger keys
- LearnDash Manage Achievement — create one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category