EmailBison (Amine) icon

EmailBison (Amine)

Interact with EmailBison API

Lead → Get Many

AI-generated

Summary

Fetches leads from EmailBison, applying optional search terms and status filters while respecting a maximum result limit per request.

Inputs

  • returnAll — If true, attempts to retrieve all leads (page 1, then subsequent pages). Note: The EmailBison API has a hard limit of 15 leads per request; pagination is handled automatically.
  • limit — If returnAll is false, specifies the maximum number of leads to return. Note: The EmailBison API ignores this parameter and always returns a maximum of 15 leads per request.
  • search — A search term used to filter leads across multiple fields.
  • filters — A collection of additional filters, including Lead Campaign Status (e.g., Replied, Sequence Finished), Verification Statuses (e.g., Verified, Bounced), Tag IDs, Excluded Tag IDs, and an option to show only leads without tags.

Output shape

a list of items, each representing a single lead

Pagination is handled automatically if returnAll is true. The API always returns a maximum of 15 leads per request.

Examples

Example 1: Retrieve up to 15 leads with a specific verification status (e.g., Verified).

Return All: false, Limit: 15, Filters: Verification Statuses set to 'Verified'

Example 2: Search for leads containing the term 'newsletter' across all fields.

Search term: 'newsletter', Return All: false

Example 3: Get all leads, including those tagged with ID '5'.

Return All: true, Filters: Tag IDs set to '5'

Links

Discussion