Lemon Squeezy icon

Lemon Squeezy

Interact with Lemon Squeezy API

Subscription Item → Get Many

AI-generated

Summary

Retrieve multiple subscription items from Lemon Squeezy, optionally filtered by subscription ID and/or price ID, with configurable sorting, pagination, and included related resources.

Inputs

  • Return All — Choose whether to return all subscription items or limit the number returned.
  • Limit — Maximum number of subscription items to return when Return All is false (1-100).
  • Filters — Optional filters to restrict results by subscription ID and/or price ID.
  • Advanced Options — Additional options to sort results by creation or update date (ascending or descending), set a pagination timeout in seconds (0 disables timeout), and include related resources such as Subscription, Price, or Usage Records in the response.
  • Simplify — Whether to simplify the response by flattening JSON:API attributes to the top level or keep the raw JSON:API format.
  • Retry Options — Configure retry behavior for failed API requests, including maximum retry attempts and initial delay before retries.

Output shape

a list of subscription items

Returns an array of subscription item objects, optionally including related resources based on the 'Include Related' setting. The response respects pagination settings and can be simplified or raw JSON:API format depending on input. API errors trigger retries up to configured limits.

Examples

Example 1: Fetch up to 50 subscription items filtered by a specific subscription ID, sorted by created date descending, including related price and usage records, returning simplified output.

Return All: false; Limit: 50; Filters: subscriptionId set; Advanced Options: sortField=created_at, sortDirection=desc, include=[price, usage-records]; Simplify: true

Example 2: Retrieve all subscription items without filters, sorted by update date ascending, without related includes, returning raw JSON:API format.

Return All: true; Filters: none; Advanced Options: sortField=updated_at, sortDirection=asc, include=[]; Simplify: false

Links

Discussion