---
title: 'Get subscriptions filtered by type and other fields'
description: 'This endpoint allows you to list stratus subscriptions. Results are cursor-paginated — page through them with `cursor` or `startingAfter` while `hasNextPage` is true — and can be narrowed by `id`, `websiteId`, `organizationId`, `chainId`, `contractAddress`, `name` and `hideInUi`.'
openapi: GET /api/stratus/subscriptions
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`GET /api/stratus/subscriptions` — query parameters: `cursor`, `startingAfter`, `limit`, `id`, `websiteId`, `organizationId`, `chainId`, `contractAddress`, `name`, `hideInUi`

`GET https://admin.snagsolutions.io/api/stratus/subscriptions`

This endpoint allows you to list stratus subscriptions. Results are cursor-paginated — page through them with `cursor` or `startingAfter` while `hasNextPage` is true — and can be narrowed by `id`, `websiteId`, `organizationId`, `chainId`, `contractAddress`, `name` and `hideInUi`.

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Query parameters

- `cursor` (string)
- `startingAfter` (string)
- `limit` (number)
- `id` (string)
- `websiteId` (string)
- `organizationId` (string)
- `chainId` (number)
- `contractAddress` (string)
- `name` (string)
- `hideInUi` (string)

## Response 200

200
  - response (object)
    - `data` (array, required)
      - `items` (object)
        - `name` (string, required)
        - `websiteId` (string, required)
        - `organizationId` (string, required)
        - `functionIds` (array)
          - `items` (string)
        - `callbackUrl` (string, required)
        - `startsAt` (string)
        - `endsAt` (string)
        - `id` (string, required)
        - `version` (string, one of: v1, v2)
        - `signingKey` (string, required)
        - `createdAt` (string, date-time, required)
        - `updatedAt` (string, date-time, required)
        - `deletedAt` (string, date-time, required)
        - `disabled` (boolean)
        - `disabledAt` (string, date-time)
        - `disabledReason` (string)
        - `consecutiveFailures` (number)
        - `blockchainSubscriptions` (array)
          - `items` (object)
            - id: … (nested further)
            - chainId: … (nested further)
            - contractAddress: … (nested further)
            - blockchainSubscriptionType: … (nested further)
            - eventSelector: … (nested further)
            - eventAbi: … (nested further)
            - functionAbi: … (nested further)
            - fromBlock: … (nested further)
            - createdAtBlock: … (nested further)
            - createdAt: … (nested further)
            - updatedAt: … (nested further)
            - deletedAt: … (nested further)
        - `snagSubscriptions` (array)
          - `items` (object)
            - id: … (nested further)
            - table: … (nested further)
            - createdAt: … (nested further)
            - updatedAt: … (nested further)
            - deletedAt: … (nested further)
    - `hasNextPage` (boolean, required)

## Response 500

500
  - response (object)
    - `error` (string, required)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip