Get recognition feed

Return a page of the recognition feed for the authenticated caller's company —
the same content shown in Bonusly's web home feed (top-level posts in
reverse-chronological order).

Filters (all optional, all combined as AND):

  • departments, locations, teams — arrays of group names; combine with
    listDepartments / listLocations to discover valid values.
  • hashtags — array of hashtag strings; leading # is optional and
    matching is case-insensitive (e.g. both "teamwork" and "#teamwork"
    match #teamwork).
  • recognition_types — subset of celebrations, awards, incentives, peer, external_recognition.
    Call listRecognitionTypes to enumerate the values.
  • current_user_only — subset of given, received
    (recognition the caller gave / received).
  • giver_id, receiver_id — restrict to a specific user.
  • relevance — when true, bias toward the caller's most-relevant
    colleagues (mirrors the web "Relevant" tab).

Pagination is cursor-based. recognitions is a single page (size limit,
default 25, max
100); 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.

Each row carries giver + receivers, amount, reason, hashtags, and top-level
vs add-on/comment shape. Add-on rows themselves are not inlined to keep
pages small.

Required OAuth scope: recognition:read or recognition:administer

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required
Allowed:
string
enum
required
Allowed:
params
object
required
string
required
Responses

401

Unauthorized

403

Forbidden

Language
Credentials
Bearer
OAuth2 access token
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json