Amocrm Rocket icon

Amocrm Rocket

Consume AmoCRM API

Lead → Get Lead List

AI-generated

Summary

Retrieves a list of leads from amoCRM based on search filters, sorting options, and pagination settings.

Inputs

  • Authentication — Type of authentication to use (OAuth2 or Long Lived Token).
  • Return All — Whether to fetch all matching leads across multiple pages or limit the result count.
  • Filter — Collection of filter criteria including query text, lead IDs, names, price range, pipelines, statuses, user assignments, and date ranges.
  • Options — Additional query settings such as custom sorting, HTTP proxy configuration, and optional related data to embed using the 'With' parameter.
  • Page — Page number of results to retrieve when 'Return All' is set to false.
  • Limit — Maximum number of lead records to return.

Output shape

a list of items

Returns an array of amoCRM lead objects. Additional related properties (e.g., contacts, loss reason) are included if configured in the 'With' options.

Examples

Example 1: Fetch all leads assigned to specific pipelines

Set 'Return All' to true, and select the target pipelines under Filter -> Pipeline Names or IDs.

Example 2: Search leads by query with pagination

Set 'Return All' to false, set Limit to 50, Page to 1, and enter a search term in Filter -> Query.

Links

Discussion