learndash/get-user-achievement-points returns a learner’s achievement points total.
It is not just the sum of their badges.
At a glance
| Ability | learndash/get-user-achievement-points |
| 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
The add-on adds any manually granted bonus points and subtracts points already spent buying courses — so the figure is a balance rather than an accumulation.
This reports the same number the learner sees, which is the one that matters when somebody asks why their total does not match their badges.
That gap is the usual support question here: a learner adds up their badge points, gets a larger number than their balance, and concludes something is broken. They spent some.
Points-for-courses is an optional feature, so on a site not using it the balance and the sum do agree — which makes the discrepancy site-specific and harder to anticipate.
learndash/list-user-achievements shows the earns behind it, with the points each carried at the time.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
learner | string | integer | Yes | User ID, login or email. |
What comes back
| Name | Type | What it is |
|---|---|---|
points | integer | The learner’s current balance. |
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:
How many points does this learner have?
It resolves to one call:
{
"ability": "learndash/get-user-achievement-points",
"parameters": {
"learner": "sam@example.com"
}
}Worth knowing
- A balance, not a sum: bonuses are added and spending is subtracted.
- This is the figure the learner sees.
- The gap from the badge sum is spending, not a fault.
- Requires the LearnDash Achievements add-on.
Related abilities
- LearnDash List User Achievements — the earns behind it
- LearnDash Award Achievement — which moves the total
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category