List recognition (bonuses) received BY a user within your company. Returns who gave them
recognition, the hashtags used, and the recognition message — plus windowed earned totals.
Use this to understand what someone has been recognized for, or for "how many points did a
user earn/receive this month?".
Identify the user with target_user (an ID, email address, or name); omit it to look up the
authenticated caller.
Time window: pass start_date and end_date (ISO YYYY-MM-DD) for calendar-based ranges
("this month", "last month", a specific month). days_back is a rolling lookback (default 90,
max 1825) and is only correct when the request is explicitly "last N days".
For windowed earned totals use total_points_received (the full-window sum of points earned)
and total_recognition_count (full-window count). Never sum the per-row amount across
recognitions — that array is one page and will undercount.
Pagination is cursor-based. recognitions is a single page (size limit, default
20, max 50);
when more pages exist next_cursor is non-null — pass it back as cursor to fetch the next
page. Keep the rest of the input identical across pages.
Required OAuth scope: recognition:read or recognition:administer
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Unauthorized
403Forbidden