Get a List of Subscriptions

Before you get started

You need to have your Access Token.

Get a List of Subscriptions

Send a GET request to https://api.tackle.io/v1/subscriptions/ with the appropriate token.

curl -L -X GET 'https://api.tackle.io/v1/subscriptions' \
-H 'Authorization: Bearer your-jwt-here'

Optional parameters are productid, customerid, clouds, start_date, and end_date.

If successful, you will receive a 200 OK response similar to the following:

{
  "data": [
    {
      "tackle_subscription_id": "52fZSV7JbMI",
      "productid": "exampleproductid",
      "product_link": "https://api.tackle.io/v1/products/exampleproductid",
      "cloud": "aws",
      "customerid": "examplecustomerid",
      "offerid": "exampleofferid",
      "created_at": "2021-11-09T12:00:00.000Z",
      "registered_at": "2021-11-10T12:00:00.000Z",
      "updated_at": "2021-11-11T12:00:00.000Z",
      "cancelled_at": "2021-11-11T12:00:00.000Z",
      "started_at": "2021-11-09T12:00:00.000Z",
      "ended_at": "2021-11-11T12:00:00.000Z",
      "link": "https://api.tackle.io/v1/subscriptions/52fZSV7JbMI"
    },
    {
      "tackle_subscription_id": "v2RFsznlfb8",
      "productid": "exampleproductid",
      "product_link": "https://api.tackle.io/v1/products/exampleproductid",
      "cloud": "aws",
      "customerid": "examplecustomerid",
      "offerid": "exampleofferid2",
      "created_at": "2021-11-12T12:00:00.000Z",
      "registered_at": "2021-11-13T12:00:00.000Z",
      "updated_at": "2021-11-13T12:00:00.000Z",
      "cancelled_at": null,
      "started_at": "2021-11-12T12:00:00.000Z",
      "ended_at": "2022-11-12T12:00:00.000Z",
      "link": "https://api.tackle.io/v1/subscriptions/v2RFsznlfb8"
    }
  ],
  "metadata": {
    "link": "https://api.tackle.io/v1/subscriptions"
  }
}

Detailed information on the subscription is available through the subscription’s link parameter. For more information, see the Get a Subscription page.

More information on the product is available via the product_link. For expanded details, see the Get a Product page.

Ready to see the code in action? Check out our Get a List of Subscriptions recipe!

🦉

Get a List of Subscriptions

Open Recipe

More example responses can be seen in the List Subscriptions API reference.