---
title: "List Notification Subscriptions for a Collection Provider"
method: GET
path: "/providers/collections/{provider_id}/subscriptions/"
tags: ["Notification Subscriptions"]
---

# List Notification Subscriptions for a Collection Provider

`GET /providers/collections/{provider_id}/subscriptions/`

Retrieve a paginated list of notification subscriptions associated with a specific collection provider for the authenticated user.
Each subscription resource represents the user's notification preferences for specific events (e.g., new pending submissions) within the specified collection provider.
## Permissions
 - The user must be authenticated.
 - The user must have existing subscriptions for the specified collection provider.

## Response Format
 - Returns a JSON:API compliant response with a `data` array containing subscription resources.
 - Each subscription includes:
   - `event_name`: The event that triggers notifications (e.g., `new_pending_submissions`).
   - `frequency`: How often notifications are sent (`instant`, `daily`, `none`).
   - `provider`: Relationship object linking to the collection provider.

## Pagination
 - Standard JSON:API pagination links (`first`, `last`, `prev`, `next`) and `meta` information
  (e.g., `total`, `per_page`) are included in the response.

## Path parameters

- `provider_id` string, required

## Response `200`

Successful response with a paginated list of subscriptions.

## Other responses

- `401` — Unauthorized. Authentication is required.
- `403` — Forbidden. The user does not have permission to access subscriptions for this provider.
- `404` — Not Found. The specified collection provider does not exist or has no subscriptions 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/3c5164c707eb/schema)