---
title: "Annual highlights for the group"
method: GET
path: "/groups/{groupId}/yearbook"
tags: ["Group features"]
---

# Annual highlights for the group

`GET /groups/{groupId}/yearbook`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/groups/{groupId}/yearbook`
- Auth: HTTP bearer

Four independent aggregations over entries, reactions and mood trackers.

## Path parameters

- `groupId` string, uuid, required

## Query parameters

- `year` integer

## Response `200`

OK

- object
  - `data` GroupYearbook, required
    - `year` integer, required
    - `topEntries` object[], required
      - `entryId` string, uuid, required
      - `diaryId` string, uuid, required
      - `occurredAt` string, required
      - `likeCount` integer, required
      - `title` string, nullable
      - `preview` string
      - `coverUrl` string, nullable
    - `topContributor` object, nullable, required
      - `userId` string, uuid, required
      - `username` string, nullable, required
      - `displayName` string, nullable, required
      - `avatarUrl` string, nullable, required
      - `entryCount` integer, required
    - `longestEntry` object, nullable, required
      - `entryId` string, uuid, required
      - `diaryId` string, uuid, required
      - `occurredAt` string, required
      - `length` integer, required
      - `title` string, nullable
      - `preview` string
      - `coverUrl` string, nullable
    - `moodTrend` object[], required
      - `month` integer, required
      - `averageMood` number, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `403`: Not a member of this group

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)