Get subscriptions

Retrieve all DNS Shield subscriptions (both Monthly and LTD) for the authenticated user. This endpoint returns comprehensive details about each subscription including status, pricing, billing cycle, slot capacity, and usage.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
  "status": 200,
  "message": "DNS Shield subscriptions retrieved",
  "data": [
    {
      "id": "sub-uuid-1",
      "subscriptionId": "ltd_pro_abc123xyz",
      "status": "ACTIVE",
      "lookupKey": "dns_shield_pro_ltd_2",
      "periodStart": "2024-01-15T00:00:00.000Z",
      "periodEnd": "2099-12-31T23:59:59.000Z",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-02-01T14:20:00.000Z",
      "cancelledByUser": false,
      "invoiceLink": "<https://invoice.stripe.com/i/acct_xxxx/test_xxxx>",
      "paymentFailureMessage": null,
      "price": 299900,
      "billingCycle": "LTD",
      "totalSlots": "500",
      "totalUsedSlots": 350,
      "planType": "PRO"
    },
    {
      "id": "sub-uuid-2",
      "subscriptionId": "sub_1AbcDefGhiJklMnop",
      "status": "ACTIVE",
      "lookupKey": "zap_dns_shield",
      "periodStart": "2024-02-01T00:00:00.000Z",
      "periodEnd": "2024-03-01T00:00:00.000Z",
      "createdAt": "2024-02-01T08:15:00.000Z",
      "updatedAt": "2024-02-01T08:15:00.000Z",
      "cancelledByUser": false,
      "invoiceLink": "<https://invoice.stripe.com/i/acct_yyyy/test_yyyy>",
      "paymentFailureMessage": null,
      "price": 15000,
      "billingCycle": "MONTHLY",
      "totalSlots": "999999",
      "totalUsedSlots": 50,
      "planType": null
    },
    {
      "id": "sub-uuid-3",
      "subscriptionId": "ltd_starter_def456uvw",
      "status": "CANCELLED",
      "lookupKey": "dns_shield_starter_ltd",
      "periodStart": "2023-12-01T00:00:00.000Z",
      "periodEnd": "2024-01-15T00:00:00.000Z",
      "createdAt": "2023-12-01T12:00:00.000Z",
      "updatedAt": "2024-01-15T09:00:00.000Z",
      "cancelledByUser": true,
      "invoiceLink": "<https://invoice.stripe.com/i/acct_zzzz/test_zzzz>",
      "paymentFailureMessage": null,
      "price": 9900,
      "billingCycle": "LTD",
      "totalSlots": "30",
      "totalUsedSlots": 30,
      "planType": "STARTER"
    }
  ]
}