> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Notifications

> Get a paginated list of app notifications for the authenticated user

Returns a paginated list of app notifications for the currently authenticated user, ordered newest first. Notifications are scoped to the calling user — a user cannot read another user's notifications.

> [!NOTE]
>
> This endpoint requires an authenticated user. Include a valid `Authorization: Bearer <accessToken>` header.

## Query Parameters

**page** `number` (default: 1)

Page number (1-indexed).

**limit** `number` (default: 5)

Number of results per page. Maximum `50`.

## Response

Returns a paginated envelope containing an array of notification objects.

**data** `array`

List of app notification objects.

**AppNotification properties**

**id** `string`

Unique notification ID (UUID).

**projectId** `string`

ID of the project this notification belongs to.

**userId** `string`

ID of the user this notification belongs to.

**type** `string`

Notification type string (e.g., `"new-follower"`, `"comment-reply"`). Defined by your webhook integration.

**action** `string`

Deep-link action string used by the client to route the user when the notification is tapped.

**isRead** `boolean`

Whether the user has marked this notification as read.

**metadata** `object`

Arbitrary key-value data attached to the notification. Contents depend on the notification type.

**createdAt** `string`

ISO 8601 timestamp when the notification was created.

**updatedAt** `string`

ISO 8601 timestamp when the notification was last updated.

**pagination** `object`

Pagination metadata.

**properties**

**page** `number`

Current page number.

**pageSize** `number`

Number of results per page.

**totalPages** `number`

Total number of pages.

**totalItems** `number`

Total number of notifications.

**hasMore** `boolean`

Whether more pages exist after this one.

## Error Responses

> [accordion] Missing token — 401
>
> No `Authorization` header was sent. The body is `text/plain`, not JSON:
>
> ```text theme={null}
> Unauthorized
> ```

> [accordion] Expired or invalid token — 403
>
> The header was sent but the token failed verification. Refresh the access
> token and retry. The body is `text/plain`, not JSON:
>
> ```text theme={null}
> Forbidden
> ```

> [accordion] Invalid Query — 400
>
> ```json theme={null}
> {
>   "error": "...",
>   "code": "app-notification/invalid-query"
> }
> ```

## See Also

* [`useAppNotifications` hook](https://docs.sublay.io/v7/hooks/app-notifications/use-app-notifications)
* [App Notifications overview](https://docs.sublay.io/v7/sdk/app-notifications/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.