---
title: "Retrieve a List of Notification Subscriptions"
method: GET
path: "/subscriptions/"
tags: ["Notification Subscriptions"]
---

# Retrieve a List of Notification Subscriptions

`GET /subscriptions/`

Retrieve a paginated list of the authenticated user's notification subscriptions.
Each subscription describes the user's preferences for receiving notifications about specific events  on OSF resources such as projects, preprints, registrations, or collections.
## Permissions
- The authenticated user can only retrieve their own subscriptions. - Authentication is required.
## Returns
- A JSON object containing a `data` array of subscription resources, each representing a single subscription. - Each subscription includes details such as the `event_name`, `frequency`, and links to related resources. - The response also includes `links` and `meta` keys for pagination support.

## Query parameters

- `page` integer
- `filter[event_name]` string

## Response `200`

Successful retrieval of the user's notification subscriptions.

## Other responses

- `401` — Unauthorized. Authentication is required.
- `403` — Forbidden. You do not have permission to access these subscriptions.
- `404` — Not Found. No subscriptions found for the user.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)