Get Subscriptions List

This endpoint returns the list of subscriptions managed by Zotlo for a specific project.

Use the GET method to retrieve all subscriptions associated with the project. The response includes the subscription details along with the related package information for each subscription.

Method	GET
URL	https://api.zotlo.com/v1/subscription/list?subscriberId=SUBSCRIBER_ID

Request Parameters

Field	Type	Description
subscriberId	Required	The email or phone number the user provided when starting the subscription.

Sample Request

GET https://api.zotlo.com/v1/subscription/list?subscriberId=SUBSCRIBER_ID HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••

You can find your AccessKey , AccessSecret and ApplicationId in the Zotlo Panel under Developer Tools → API Keys

Successful Response

If you have a subscription and it is active:

{
  "meta": {
    "requestId": "246a8e676214-REQ-65aa29fa49acb",
    "httpStatus": 200
  },
  "result": [
    {
      "status": "active",
      "realStatus": "active",
      "subscriberId": "[e-mail]",
      "subscriptionType": "paid",
      "startDate": "2024-01-15 12:57:56",
      "expireDate": "2024-02-15 12:57:56",
      "package": "web_new",
      "language": "tr",
      "country": "TR",
      "phoneNumber": null,
      "originalTransactionId": "6e0ef399-4c74-46a5-a7dd-95a76e1b3a59",
      "cancellation": null,
      "quantity": 1,
      "pendingQuantity": 0,
      "customParameters": []
    },
    {
      "status": "active",
      "realStatus": "active",
      "subscriberId": "[e-mail]",
      "subscriptionType": "paid",
      "startDate": "2024-01-19 07:51:03",
      "expireDate": "2024-02-19 07:51:03",
      "package": "web_premium",
      "language": "ru",
      "country": "RU",
      "phoneNumber": null,
      "originalTransactionId": "a24924ea-95d7-4e02-bcb2-d1d442500ec6",
      "cancellation": null,
      "quantity": 1,
      "pendingQuantity": 0,
      "customParameters": []
    }
  ]
}

Failed Response

All failed responses follow the same standard error format. (See: Error Handling)