---
title: "Get Subscriptions"
method: GET
path: "/v2/issuers/{organizationId}/subscriptions"
tags: ["notifications > Subscriptions"]
---

# Get Subscriptions

`GET /v2/issuers/{organizationId}/subscriptions`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/subscriptions`
- Auth: HTTP bearer

Call this endpoint to fetch the subscriptions of the provided issuer.<br/>
<b>Required scopes:</b> `notifications:read`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard

## Query parameters

- `filter[eventName]` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile'

## Response `200`

Response with status 200

- NotificationsSubscriptionsSubscriptionsResponseObject
  - `data` NotificationsSubscriptionsSubscriptionUnion[], required
    - `type` 'subscription', required: Discriminator value: subscription
    - `id` string, required: The ID of the subscription
    - `attributes` NotificationsSubscriptionsSubscriptionAttributes, required
      - `eventName` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile', required
      - `webhookUrl` string, required: The URL to which notifications will be sent
      - `enabled` boolean, required: Indicates whether the subscription is active

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`
- **2026-10-19** `a664c5d23771`: 1 warning, 1 info
  - added the new `payoutReconciliationFile` enum value to the `data/items/oneOf[subschema #1]/attributes/eventName` response property for the response status `200`
  - added the new enum value `payoutReconciliationFile` to the `query` request parameter `filter[eventName]`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/subscriptions/get.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)