ServiceTitan icon

ServiceTitan

ServiceTitan field service management — customers, jobs, appointments, estimates, invoices, bookings, leads, calls, locations, memberships, technicians, payments, tags, tasks

Lead → Get Many

AI-generated

Summary

Retrieves ServiceTitan leads, optionally returning all pages or limiting the result count. Optional filters narrow results by active status, modification or creation dates, and customer ID.

Inputs

  • Return All — When enabled, fetches all available pages; otherwise, returns up to the Limit.
  • Limit — Maximum number of leads to return when Return All is off; defaults to 50, with a declared range of 1–5000.
  • Filters — Optional filters: Active (any, active, or inactive), Modified After/Before, Created After/Before, and Customer ID.

Output shape

a list of lead records

With Return All enabled, the operation follows ServiceTitan's page-based pagination until no more pages are available; otherwise, the configured limit is used.

Examples

Example 1: List up to 50 leads for a customer

Leave Return All off, keep the default Limit of 50, and set Filters → Customer ID.

Example 2: Fetch all active leads created after a date

Enable Return All, set Filters → Active to Active and Created After to the desired date.

Links

Discussion