List recognition (bonuses) given BY a user to others within your company. Returns
recipients, hashtags, the recognition message, and the giver's per-recognition spend.
Use for "When did a user recognize X?", "What have they recognized people for?", or
"How many points did a user give this month?".
Identify the giver with target_user (an ID, email address, or name); omit it to look up
the authenticated caller. Optionally narrow to recognition given TO a specific person with
receiver_user, or to a group with target_group.
Cost model (important for math): a recognition's points_per_recipient is the amount on the
post; the giver pays points_per_recipient * recipient_count. Use
total_points_spent_by_giver for the giver-side total — never split a post amount across
recipients, and never sum the per-row cost across recognitions (that array is one page;
the summary totals cover the full window).
Time window: pass start_date and end_date (ISO YYYY-MM-DD) for calendar ranges
("this month", a specific month). days_back is a rolling lookback (default 90, max 1825)
and is only correct for "last N days".
Cursor pagination: set the filters and page_size on the first call; to fetch the next page
pass ONLY the returned next_cursor (it encodes the filters, page size, and position — no
other arguments are needed or read). A null next_cursor means there are no more pages.
Required OAuth scope: recognition:read or recognition:administer
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Unauthorized
403Forbidden