List All Subscription Items

GET

/v1/subscription-items

Returns a paginated list of subscriptions items.


Filter parameters

subscription_id

Only return subscription items belonging to a subscription with this ID.

price_id

Only return subscription items belonging to a price with this ID.


curl "https://api.lemonsqueezy.com/v1/subscription-items" \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer {api_key}'
curl "https://api.lemonsqueezy.com/v1/subscription-items?filter[subscription_id]=1" \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer {api_key}'

Returns

Returns a paginated list of Subscription objects ordered by created_at in descending order.

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 10,
      "to": 10,
      "total": 10
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "https://api.lemonsqueezy.com/v1/subscription-items?page%5Bnumber%5D=1&page%5Bsize%5D=10&sort=-created_at",
    "last": "https://api.lemonsqueezy.com/v1/subscription-items?page%5Bnumber%5D=1&page%5Bsize%5D=10&sort=-created_at"
  },
  "data": [
    {
      "type": "subscription-items",
      "id": "1",
      "attributes": {
        "subscription_id": 1,
        "price_id": 1,
        "quantity": 1,
        "is_usage_based": false,
        "created_at": "2023-07-18T12:16:24.000000Z",
        "updated_at": "2023-07-18T12:16:24.000000Z"
      },
      "relationships": {
        "subscription": {
          "links": {
            "related": "https://api.lemonsqueezy.com/v1/subscription-items/1/subscription",
            "self": "https://api.lemonsqueezy.com/v1/subscription-items/1/relationships/subscription"
          }
        },
        "price": {
          "links": {
            "related": "https://api.lemonsqueezy.com/v1/subscription-items/1/price",
            "self": "https://api.lemonsqueezy.com/v1/subscription-items/1/relationships/price"
          }
        },
        "usage-records": {
          "links": {
            "related": "https://api.lemonsqueezy.com/v1/subscription-items/1/usage-records",
            "self": "https://api.lemonsqueezy.com/v1/subscription-items/1/relationships/usage-records"
          }
        }
      },
      "links": {
        "self": "https://api.lemonsqueezy.com/v1/subscription-items/1"
      }
    },
    {...},
    {...}
  ]
}

Was this page helpful?