List recognition (bonuses) received BY a user within your company. Returns who gave them
recognition, the hashtags used, and the recognition message. Use this to understand what
someone has been recognized for, or for "what peer recognition did I receive?".
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".
Event-anchored lookups (birthday, work anniversary, a project name): pass keyword as a
case-insensitive substring of the recognition message. When keyword is set and
start_date / days_back are omitted, the window defaults to 1825 days.
For per-row amounts, use the amount field on each recognition. Sum
them for totals within a page; for full-window totals, walk the pages
via next_cursor and accumulate.
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