Zoho BillingInstall

Summary

Lists subscriptions from Zoho Billing (GET /billing/v1/subscriptions) for a chosen organization, with optional status, customer and reference filters, and returns each subscription as a separate output item.

Inputs

• organizationId (required) — Zoho Billing organization, picked from a list loaded from the account. Sent as the X-com-zoho-subscriptions-organizationid header.
• returnAll — If true, fetches every page (200 per page) until a page returns fewer than 200 items. Default false.
• limit — Maximum number of subscriptions to return when Return All is off (minimum 1, default 200). Sent as per_page for a single page request (page=1).
• filterBy — Status filter passed as filter_by, using Zoho's documented values (e.g. Status.All). Omitted if empty.
• customerId — Restricts results to subscriptions for this customer (customer_id). Omitted if empty.
• referenceContains — Filters by text contained in the subscription reference (reference_contains). Omitted if empty.

Output shape

One output item per subscription object from the response's subscriptions array, each linked to its input item via pairedItem.

Without Return All, only one page of up to limit items is fetched, and Zoho's per-page cap may apply. Non-object entries are dropped. If a request fails and Continue On Fail is enabled, an item with {error: message} is output instead. The API base URL is derived from the credential (override, api_domain, or region).

Examples

Example 1: Fetch all active subscriptions for reporting

Select Organization, Return All = true, Filter By = Status.Active

Example 2: Look up a customer's subscriptions

Select Organization, Customer ID = the Zoho customer ID (e.g. from an expression), Return All = false, Limit = 50

Example 3: Find subscriptions by an external reference

Select Organization, Reference Contains = 'ORDER-', Return All = true

Links

• n8n community nodes installation guide