---
title: "List owned subscriptions"
method: GET
path: "/apps/subscriptions"
tags: ["Apps"]
---

# List owned subscriptions

`GET /apps/subscriptions`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/apps/subscriptions`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

List subscriptions for this user. Any authenticated user (including agents via session, PAT, or stateless agent JWT) sees only their own rows.

## Query parameters

- `skip` number
- `limit` number, nullable
- `direction` 'older' | 'newer', nullable
- `date` string

## Response `200`

- ListSubscriptionsResponse
  - `pagination` ListSubscriptionsPagination, required
    - `skip` number
    - `limit` number, nullable: Max number of results allowed per page is: **100**
    - `direction` 'older' | 'newer', nullable
    - `date` string: ISO 8601 date string for cursor pagination
  - `total_results` number, required
  - `results` Subscription[], required
    - `created_at` string, date-time, required: The date and time at which the resource was created.
    - `updated_at` string, date-time, required: The date and time at which the resource was last updated.
    - `id` string, required: The primary key of the resource.
    - `client_id` string, required
    - `user_id` string, required
    - `subscriptions` string[], required: Array of subscription events or triggers (including "schedule" for time-based triggers)
    - `webhookURL` string: Webhook URL to send the data
    - `subscription_filters` SubscriptionFilter[]
      - `key` string, required: What is the key to filter the data before sending to the webhook
      - `value` union, required: Must match `operator`: use a string or number for "eq" and "ne"; use a non-empty array only for "in".
        - string
        - number
        - string[]
      - `operator` 'eq' | 'ne' | 'in', required: What is the operator to filter the data
    - `subscription_actions` SubscriptionAction[]
      - `action_id` 'run_ai_prompt' | 'send_channel_message_reminder', required: What is the action to perform
      - `entity_type` 'ai_prompt' | 'channel_reminder': What is the entity_type to perform the action on (required when entity_id is provided)
      - `entity_id` string: What is the entity_id to perform the action on (required when entity_type is provided)
      - `metadata` ActionMetadata
        - `conversation_id` string: The conversation/channel ID where the reminder message should be sent
        - `send_as_bot` boolean: Whether the message should be sent as a bot. If true, bot_user_id should be provided
        - `message` string: The message text to send. Either message or from_message_id must be provided
        - `links` string[]: Array of links to be attached to the message
    - `webhook_headers` object: Custom HTTP headers forwarded on webhook deliveries for this subscription.

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)