# LeadIQ

The Smart B2B Prospecting Platform. Query professional information about people and companies, find leads, and enrich contact data.

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `LEADIQ`
- **Version:** 00000000_00

## Tools

### Abandon Import Batch

**Slug:** `LEADIQ_ABANDON_BATCH`

Abandon a contact tracking import batch that is no longer needed. Use when you need to cancel or stop an ongoing import batch operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional reason for abandoning the batch. Provide context about why this batch is being abandoned. |
| `importId` | string | Yes | The ID of the import batch to abandon. This should be the unique identifier of the contact tracking import batch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Details

**Slug:** `LEADIQ_GET_ACCOUNT`

Retrieve current user's account information including plans, billing cycles, and credit usage. Use to check available API credits, billing status, and data visibility settings before making data queries.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Tracking Balance

**Slug:** `LEADIQ_GET_CONTACT_TRACKING_BALANCE`

Tool to check the remaining balance of contact tracking credits available for the account. Use when you need to verify how many contact tracking credits are left.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage Statistics

**Slug:** `LEADIQ_GET_USAGE`

Tool to retrieve API usage statistics and credit consumption for the current LeadIQ account. Use when you need to check credit usage, remaining capacity, or billing information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Company

**Slug:** `LEADIQ_SEARCH_COMPANY`

Tool to search for companies by name, domain, LinkedIn URL, or other identifying information. Use when you need to find companies matching specific criteria. Returns detailed company information including employee count, industry, location, and social profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | object | Yes | Search criteria for finding companies. At least one search field (name, domain, linkedinId, or linkedinUrl) should be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Grouped Advanced

**Slug:** `LEADIQ_SEARCH_GROUPED_ADVANCED`

Tool to search for people by job title, seniority, role, company size, and location with results grouped by company. Returns companies with matching people nested under each company for account-based prospecting. Use when you need to find contacts at companies matching specific criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | object | Yes | Advanced search criteria for grouped results with people nested under companies |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search People

**Slug:** `LEADIQ_SEARCH_PEOPLE`

Search for individual contacts by name, company (past and present), LinkedIn profile, email, or phone number. Use when you need to find people based on identifying information. Returns comprehensive contact data including work/personal emails, phones, employment history, education, and social profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Person identifier to search for a specific person by their LeadIQ ID |
| `skip` | integer | No | Number of results to skip for pagination. Use with limit to paginate through results |
| `email` | string | No | Email address to search for a person |
| `limit` | integer | No | Maximum number of results to return. Default and maximum is 100 |
| `phone` | string | No | Phone number to search for a person. Can include country code |
| `company` | object | No | Company details for filtering search results. |
| `fullName` | string | No | Full name of the person to search for. Alternative to using firstName and lastName separately |
| `lastName` | string | No | Last name of the person to search for |
| `firstName` | string | No | First name of the person to search for |
| `linkedinId` | string | No | LinkedIn identifier to search for a person by their LinkedIn ID |
| `middleName` | string | No | Middle name of the person to search for |
| `hashedEmail` | string | No | SHA256 hashed email address for privacy-preserving search |
| `linkedinUrl` | string | No | LinkedIn profile URL to search for a person |
| `minConfidence` | integer | No | Minimum confidence score threshold (0-100). Only return results with confidence scores at or above this value. Higher scores indicate more reliable data |
| `profileFilter` | array | No | Filter results by profile characteristics. Only return people who match at least one of the specified profile types |
| `qualityFilter` | string ("valid" | "invalid" | "unknown") | No | Phone quality filter values. |
| `includeInvalid` | boolean | No | Include people with invalid email addresses in results. By default, invalid emails are excluded |
| `workEmailStatusIn` | array | No | Filter results by work email verification status. Only return people whose work email matches one of these statuses |
| `containsWorkContactInfo` | boolean | No | Filter to only return people who have work contact information (work email or work phone). Set to true to require work contacts, false to exclude them, or omit for no filtering |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Flat Advanced Search

**Slug:** `LEADIQ_SEARCH_PEOPLE_FLAT`

Tool to search for people using advanced filters by job title, seniority, role, company size, location, and more. Returns a flat list of individual contacts unorganized by company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | object | Yes | Search criteria including company filters, contact filters, and pagination parameters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Person Feedback

**Slug:** `LEADIQ_SUBMIT_PERSON_FEEDBACK`

Tool to submit data correction feedback for person contact information to improve LeadIQ data accuracy. Use when you need to report contact info status, invalid reasons, or update profile details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Full name of the person. |
| `type` | string | No | Contact information type. Specifies whether it's personal or work-related contact info. |
| `title` | string | No | Job title of the person. |
| `value` | string | Yes | Contact information - MUST be a valid email address or phone number format (required). |
| `status` | string | No | Contact information status. Use 'Correct' if verified working, 'Invalid' if not working. |
| `lastSeen` | string | No | Timestamp of last verification in ISO 8601 format. |
| `personId` | string | No | Person identifier in LeadIQ system. |
| `companyId` | string | No | Company identifier in LeadIQ system. |
| `linkedinId` | string | No | LinkedIn identifier for the person. |
| `companyName` | string | No | Name of the company the person works for. |
| `linkedinUrl` | string | No | LinkedIn profile URL of the person. |
| `companyDomain` | string | No | Company website domain. |
| `invalidReason` | string | No | Error classification for invalid data. Provide specific reason if status is Invalid (e.g., EmailBounceCode513, WrongNumber). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |