---
title: "Get the authenticated user's in-app notification feed, most recent first"
method: GET
path: "/v2/notifications/feed"
tags: ["Notifications Feed Api Service"]
---

# Get the authenticated user's in-app notification feed, most recent first

`GET /v2/notifications/feed`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/notifications/feed`
- Auth: none declared

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `unreadOnly` boolean, required

## Response `200`

Paginated feed plus unread count

- JsonOkResponseNotificationFeedPageDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` NotificationFeedPageDto: One page of the authenticated user's in-app notification feed
    - `page` PageDtoNotificationFeedItemDto: Paginated feed items
      - `elements` NotificationFeedItemDto[]
        - `id` integer: Notification row id
        - `eventType` string: Notification event type id
        - `text` string: Display text for this notification
        - `link` string: Relative link to the notification's destination (post, connections screen, etc.)
        - `read` boolean: Whether the notification has already been read
        - `actor` NotificationActorDto: The user who triggered a notification, when this event type has one
          - `name` string: Display name to show (profile name, or the actor's email if they have none configured)
          - `regularUserId` integer: The actor's regular user id, when they have a Metricool account (null for an agency-managed actor or one with no account)
          - `agencyId` integer: The actor's agency id, when they are an agency-managed user (null otherwise)
          - `agencyUserId` integer: The actor's agency-managed user id (null otherwise)
        - `createdAt` DateTimeInfo
          - `dateTime` string, required: Local Date-time represented with a certain timezone
          - `timezone` string: Timezone applied to the datetime
        - `network` string: Social network id this notification is about, blank when not applicable
        - `noteText` string: The note's content, only present for postNote
        - `scheduledDate` string: ISO scheduled/publish date of the post this notification is about, blank when not applicable; for monthlyReport this instead carries the first day of the covered month, not a post's date
        - `accountName` string: Connected account name, only present for accountTokenExpired
        - `networks` string[]: Every network id the post targets — populated for postNote/postApproved/postRejected, which are post-level events (a post can target several networks at once); for aiNetworkInstructionsGenerated, every network of the generation; for manualPostPending, the single network the post has to be published on by hand; empty otherwise
        - `prompt` string: The prompt behind the notification, truncated; populated for nlSchedulingJobFinished/nlSchedulingJobFailed (the natural-language prompt that launched the job) and for studioReportFinished/studioReportFailed (the prompt used to generate the Studio report, truncated to 300 characters), blank otherwise
        - `postsCount` integer: Number of posts generated by the job, only present for nlSchedulingJobFinished
        - `errorMessage` string: The job's failure reason; populated for nlSchedulingJobFailed and for a failed single-network aiNetworkInstructionsGenerated, blank otherwise
        - `brandNames` string[]: Label of every brand the Studio report's content was matched to; only present for studioReportFinished/studioReportFailed
        - `failedNetworks` string[]: Networks whose AI instructions generation failed, only for aiNetworkInstructionsGenerated; the rest of networks succeeded. Empty otherwise
      - `pageNumber` integer
      - `pageSize` integer
      - `totalElements` integer
    - `unreadCount` integer: Total unread notifications for the user, within the 30-day retention window

## Other responses

- `400`: Delegated proxy sessions (integrator/alias/Vendasta) cannot access the feed

---

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