Plugin Subscriptions

Get all plugin subscriptions

GET

http://localhost:3000/api/plugins/{pluginId}/subscriptions

curl -X GET 'http://localhost:3000/api/plugins/550e8400-e29b-41d4-a716-446655440000/subscriptions?relations=string'

const response = await fetch('http://localhost:3000/api/plugins/550e8400-e29b-41d4-a716-446655440000/subscriptions?relations=string', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('http://localhost:3000/api/plugins/550e8400-e29b-41d4-a716-446655440000/subscriptions?relations=string')
print(response.text)

200

[
  {
    "deletedAt": "2018-11-21T06:20:32.232Z",
    "createdAt": "2018-11-21T06:20:32.232Z",
    "updatedAt": "2018-11-21T06:20:32.232Z",
    "id": "string",
    "isActive": true,
    "isArchived": false,
    "archivedAt": "2018-11-21T06:20:32.232Z",
    "tenantId": "string",
    "organizationId": "string",
    "status": "active",
    "scope": "tenant",
    "startDate": "2024-01-15T09:30:00Z",
    "endDate": "2024-01-15T09:30:00Z",
    "trialEndDate": "2024-01-15T09:30:00Z",
    "autoRenew": true,
    "cancelledAt": "2024-01-15T09:30:00Z",
    "cancellationReason": "string",
    "metadata": {},
    "externalSubscriptionId": "string",
    "pluginId": "string",
    "pluginTenantId": "string",
    "planId": "string",
    "subscriberId": "string",
    "parentId": "string",
    "children": [],
    "billings": [
      "string"
    ]
  }
]

Parameters

pluginIdstring<uuid>requiredpath

Plugin ID

pluginTenantIdstringquery

Plugin Tenant ID

subscriberIdstringquery

Filter by subscriber ID

statusstringactivecancelledexpiredtrialpast_duesuspendedpendingquery

Filter by subscription status

subscriptionTypestringfreetrialbasicpremiumenterprisecustomquery

Subscription type

scopestringtenantorganizationuserquery

Subscription scope

expiringbooleanquery

Show only expiring subscriptions

daysnumberquery

Days until expiry (default: 7)

activebooleanquery

Show only active subscriptions

relationsArray<string>requiredquery

Response

200OKArray<PluginSubscription_1>

Plugin subscriptions retrieved successfully

Response fields application/json

Array<PluginSubscription_1>

Show child attributes

deletedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

createdAtstring<date-time>

The creation timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

updatedAtstring<date-time>

The last update timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

idstring

isActivebooleantrue

isArchivedbooleanfalse

archivedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

tenantIdstring

organizationIdstring

statusstringactivecancelledexpiredtrialpast_duesuspendedpendingrequired

Subscription status

scopestringtenantorganizationuserrequired

Subscription scope

startDatestring<date-time>required

Start date of subscription

endDatestring<date-time>

End date of subscription

trialEndDatestring<date-time>

Trial end date

autoRenewbooleanrequired

Whether auto-renewal is enabled

cancelledAtstring<date-time>

Cancellation date

cancellationReasonstring

Cancellation reason

metadataobject

Subscription metadata for additional data

externalSubscriptionIdstring

External subscription ID from payment provider

pluginIdstringrequired

Plugin ID

pluginTenantIdstringrequired

Plugin Tenant ID

planIdstring

Subscription plan ID

subscriberIdstring

Subscriber user ID for user-specific subscriptions

parentIdstring

Parent subscription ID for hierarchical subscriptions

parentPluginSubscription_1

Parent subscription (for subscriptions created through assignment)

Show child attributes

PluginSubscription_1

childrenArray<PluginSubscription_1>

Child subscriptions (user subscriptions created through assignment)

Same fields as PluginSubscription_1

billingsArray<string>

Plugin billings for this subscription

Stack Overflow Website Demo