# My Redemptions

> Use when someone wants to see their own reward redemptions — what they've redeemed, the status of a reward, where a gift card or claim link is, or whether a redemption went through.

- Skill: `bonusly/my-redemptions` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bonusly/my-redemptions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bonusly/my-redemptions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bonusly (https://skillmd.com/u/bonusly)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bonusly/my-redemptions

---

This skill is the employee-facing view of your own reward redemptions — "what have I redeemed?", "where's my gift card?", or "did my redemption go through?". It's read-only and scoped to the calling user. For admins processing other people's redemptions, use `process-redemptions`; for company-wide spend reporting, use `rewards-spend-report`.

For a list of the caller's redemptions, call `getMyRedemptions`. It returns redemptions newest-first with each one's state, catalog/reward details, and claim and certificate URLs. `total_count` is the caller's full count; `redemptions` is one page. It's cursor-paginated:
* Pass `limit` (1–100, default 20) on the first call.
* When `next_cursor` is non-null there are more pages — pass it back as `cursor` and keep `limit` identical across pages.

For a single redemption the user is asking about specifically, call `getRedemption` with its `id`. The caller can always read their own redemptions; reading someone else's requires a rewards-admin role, so for the personal use case this is fine.

When summarizing, lead with what the user actually wants: the current **state** of each redemption and, when it's fulfilled, the **claim or certificate URL** so they can get to their reward. If a redemption is still pending or unfulfilled, say so plainly and set expectations rather than implying it's ready.

If the user has no redemptions, say so simply. If they're looking for a specific reward and it's not on the first page, offer to paginate before giving up.

**Access note:** listing your own redemptions requires `rewards:read`. If a call fails on permissions, surface the required scope.