Lemon Squeezy icon

Lemon Squeezy

Interact with Lemon Squeezy API

Customer → Get Many

AI-generated

Summary

Retrieves a list of customers from Lemon Squeezy, either all of them via pagination or up to a set limit, with optional filtering, sorting, and inclusion of related resources.

Inputs

  • Return All — If true, follows pagination to fetch every matching customer. Default false.
  • Limit — Max results to return when Return All is off (1–100, default 50).
  • Filters — Collection of API filters: Store ID, Email, and Status (subscribed, unsubscribed, archived, requires_verification, invalid_email, bounced).
  • Advanced Options — Sort Field (created_at or updated_at), Sort Direction (asc/desc, default desc), Pagination Timeout in seconds for Return All (default 300, 0 = no timeout, max 600), and Include Related (store, orders, subscriptions, license-keys).
  • Simplify — When on (default), flattens JSON:API attributes to the top level of each item, including any included related resources under relationship keys. When off, returns raw JSON:API objects with type, attributes and relationships.
  • Retry Options — Max Retries (default 3, 0 disables) and Initial Delay in ms (default 1000, doubles each retry) for failed API requests.

Output shape

A list of customer items, one n8n item per customer. Simplified by default to flat objects with id, type and attribute fields; raw JSON:API format if Simplify is off.

Without Return All, results are capped by Limit (max 100). With Return All, pagination stops if the Pagination Timeout is exceeded, which raises an error. Related resources appear only if selected in Include Related. API errors surface as node errors after retries.

Examples

Example 1: Pull all subscribed customers for one store

Return All = true; Filters: Store ID = 12345, Status = Subscribed.

Example 2: Find a customer by email along with their orders

Filters: Email = jane@example.com; Advanced Options: Include Related = Orders; Limit = 1.

Example 3: Get the 20 most recently created customers

Return All = false; Limit = 20; Advanced Options: Sort Field = Created At, Sort Direction = Descending.

Links

Discussion