# LeadIQ

> Find people's verified work emails and phone numbers, look up companies, prospect by title, seniority, industry, size, technology and hiring, and keep prospect and company lists in LeadIQ.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/leadiq

## Actions

### Add companies to company list

Save a company, or up to 100 from an earlier step, into a company list. A company already there is updated, not added twice. Free.

**Inputs**

- Company list (`company_list_id`, text, required): The company list. Pick one, or give its id from an earlier step.
- Website domain (`domain`, text): The company's domain, such as acme.com.
- Name (`name`, text): The company's name.
- LeadIQ company ID (`company_id`, text): The company's LeadIQ id, from a search: the best match.
- LinkedIn page (`linkedin_url`, text): The company's LinkedIn page.
- Notes (`notes`, text): Your notes on the company.
- More companies (`companies`, list): A list of companies from an earlier step, such as 'Find companies', each with an id, companyId, name, domain or linkedinUrl.

**Outputs**

- `count` (number): How many were saved
- `created` (number): How many were new to the list
- `failed` (list): Companies that couldn't be saved
- `succeeded` (list): The entries saved
- `updated` (number): How many were already there and updated

**Example output**

```json
{
  "count": 1,
  "created": 1,
  "failed": [],
  "succeeded": [
    {
      "companyId": "MergedCompany-5a1d839824000024005e2b09",
      "createdAt": "2026-10-01T09:00:00Z",
      "domain": "acme.com",
      "id": "65a1b2c3d4e5f6a7b8c9d0e2",
      "linkedinUrl": "https://www.linkedin.com/company/acme",
      "name": "Acme",
      "notes": "Strong fit",
      "updatedAt": "2026-10-01T09:00:00Z"
    }
  ],
  "updated": 0
}
```

### Add prospect to list

Save a person into a prospect list with the details you have, such as from 'Find a person'. Their company is filed into the list too. Free.

**Inputs**

- Prospect list (`list_id`, text, required): The prospect list. Pick one, or give its id from an earlier step.
- First name (`first_name`, text, required): The person's first name.
- Last name (`last_name`, text, required): The person's last name.
- Work email (`work_email`, text): Their work email address.
- Email status (`email_status`, text): How sure you are of the work email. Leave empty if you don't know. One of: `Verified`, `VerifiedLikely` (Likely verified), `Unverified`.
- Phone (`phone`, text): Their mobile phone number.
- Job title (`title`, text): Their job title.
- Seniority (`seniority`, text): Their level. Choose Other if none fits. One of: `Executive`, `VP`, `Director`, `Manager`, `SeniorIndividualContributor` (Senior individual contributor), `Other`.
- Company (`company`, text): Their employer's name.
- Company domain (`company_domain`, text): Their employer's website domain.
- LinkedIn profile (`linkedin_url`, text): Their LinkedIn profile address.
- LeadIQ person ID (`person_id`, text): Their LeadIQ person id, from 'Find a person' or 'Find people'.
- LeadIQ company ID (`company_id`, text): Their employer's LeadIQ id, from a search, so the company is saved once.
- Job function (`job_function`, text): Their function, such as Sales.
- Company industry (`company_industry`, text): Their employer's industry.
- City (`city`, text): The city they are in.
- State or region (`state`, text): The state or region they are in.
- Country (`country`, text): The country they are in.
- Notes (`notes`, text): Your notes on them, up to 5,000 characters.

**Outputs**

- `prospect` (object): The saved prospect

**Example output**

```json
{
  "prospect": {
    "company": {
      "domain": "acme.com",
      "employees": 180,
      "id": "MergedCompany-5a1d839824000024005e2b09",
      "industry": "Computer Software",
      "name": "Acme",
      "phone": "+1 512 555 0199"
    },
    "createdAt": "2026-10-01T09:00:00Z",
    "emailStatus": "Verified",
    "firstName": "Jo",
    "function": "Sales",
    "id": "64f1c2a9e4b0a1b2c3d4e5f7",
    "lastName": "Bloggs",
    "linkedinId": "jobloggs",
    "linkedinUrl": "https://www.linkedin.com/in/jobloggs",
    "listIds": [
      "64f1c2a9e4b0a1b2c3d4e5f6"
    ],
    "location": {
      "city": "Austin",
      "country": "United States",
      "formatted": "100 Congress Ave, Austin, TX 78701, United States",
      "state": "Texas",
      "streetLine1": "100 Congress Ave",
      "streetLine2": "",
      "zip": "78701"
    },
    "mobilePhones": [
      {
        "status": "Verified",
        "value": "+1 512 555 0100"
      }
    ],
    "name": "Jo Bloggs",
    "notes": "Met at SaaStr",
    "personId": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
    "personalEmails": [
      "jo@example.com"
    ],
    "picture": "https://example.com/jo.png",
    "seniority": "VP",
    "title": "VP of Sales",
    "updatedAt": "2026-10-01T09:00:00Z",
    "workEmail": "jo.bloggs@acme.com"
  }
}
```

### Create company list

Create a company list. Each of your lists needs a different name. Free.

**Inputs**

- Name (`name`, text, required): The list's name, different from your other company lists.
- Description (`description`, text): What the list is for.

**Outputs**

- `company_list` (object): The company list

**Example output**

```json
{
  "company_list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Software companies in Texas",
    "id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Target accounts",
    "updatedAt": "2026-10-01T09:00:00Z"
  }
}
```

### Create prospect list

Create a prospect list to save people into. Free.

**Inputs**

- Name (`name`, text, required): The list's name.
- Description (`description`, text): What the list is for.

**Outputs**

- `list` (object): The prospect list

**Example output**

```json
{
  "list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Sales leaders in Texas",
    "endDate": "2026-09-30",
    "id": "64f1c2a9e4b0a1b2c3d4e5f6",
    "name": "Q3 Outbound",
    "startDate": "2026-07-01",
    "status": "Active",
    "updatedAt": "2026-10-01T09:00:00Z",
    "visibility": "Private"
  }
}
```

### Delete company list

Delete a company list you own and the entries in it. This can't be undone; the companies' own data is untouched. A list that also holds prospects isn't deleted. Free.

**Inputs**

- Company list (`company_list_id`, text, required): The company list. Pick one, or give its id from an earlier step.

**Outputs**

- `company_list` (object): The list deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "company_list": {
    "deletedCompanies": 12,
    "id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Target accounts"
  },
  "deleted": true
}
```

### Find a company

Look up a company by website domain, name or LinkedIn page, with its size, industry, revenue, funding, location and technologies. Spends 3 credits for each company returned, and is never retried once it may have reached LeadIQ.

**Inputs**

- Website domain (`domain`, text): The company's domain, such as acme.com.
- Name (`name`, text): The company's name.
- LinkedIn page (`linkedin_url`, text): The company's LinkedIn page.
- LeadIQ company ID (`company_id`, text): The company's LeadIQ id, from a search.
- Exact match only (`strict`, true/false): Only return a company matching everything given. Off by default.

**Outputs**

- `companies` (list): The companies matched, best first
- `count` (number): How many are on this page
- `has_more` (true/false): Whether more matched than were returned
- `total_results` (number): How many matched in all

**Example output**

```json
{
  "companies": [
    {
      "description": "Acme makes software for sales teams.",
      "domain": "acme.com",
      "emailDomains": [
        "acme.com"
      ],
      "employeeRange": "51-200",
      "foundedYear": 2012,
      "fundingInfo": {
        "fundingRounds": "3",
        "fundingTotalUsd": 42000000,
        "lastFundingOn": "2024-05-01T00:00:00Z",
        "lastFundingType": "Series B",
        "lastFundingUsd": 30000000
      },
      "id": "MergedCompany-5a1d839824000024005e2b09",
      "industry": "Computer Software",
      "linkedinId": "1234567",
      "linkedinUrl": "https://www.linkedin.com/company/acme",
      "locationInfo": {
        "areaLevel1": "Texas",
        "city": "Austin",
        "country": "United States",
        "formattedAddress": "100 Congress Ave, Austin, TX 78701, United States",
        "postalCode": "78701"
      },
      "logoUrl": "https://example.com/acme.png",
      "naicsCode": {
        "code": "511210",
        "description": "Software Publishers"
      },
      "name": "Acme",
      "numberOfEmployees": 180,
      "phones": [
        "+1 512 555 0199"
      ],
      "revenue": 25000000,
      "revenueRange": {
        "description": "$10M - $50M",
        "end": 50000000,
        "start": 10000000
      },
      "sicCode": {
        "code": "7372",
        "description": "Prepackaged Software"
      },
      "specialities": [
        "Sales software"
      ],
      "technologies": [
        {
          "category": "CRM",
          "name": "Salesforce"
        }
      ]
    }
  ],
  "count": 1,
  "has_more": false,
  "total_results": 1
}
```

### Find a person

Find someone you already know of, by LinkedIn profile, email, or name and company, with their job, LinkedIn and the contact details you choose. Spends credits for each detail returned (work email 1, phones 10, company details 3), and is never retried once it may have reached LeadIQ.

**Inputs**

- LinkedIn profile (`linkedin_url`, text): Their LinkedIn profile address: the surest match.
- Email (`email`, text): An email address of theirs.
- First name (`first_name`, text): Their first name.
- Last name (`last_name`, text): Their last name.
- Company (`company_name`, text): Where they work, by name.
- Company domain (`company_domain`, text): Where they work, by website domain, such as acme.com.
- Include (`include`, list): The contact details to get, each spending credits. Leave empty for their name, job and LinkedIn only. One or more of: `work_email` (Work email (1 credit a person)), `phone` (Phone numbers (10 credits a person)), `personal_email` (Personal email (1 credit a person)), `company` (Company details (3 credits a company)).
- LeadIQ person ID (`person_id`, text): Their LeadIQ id, from a search.
- Matches (`limit`, number): How many possible matches to return, 1 to 10. Defaults to 1. From 1 to 10.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether more matched than were returned
- `people` (list): The people matched, best first
- `total_results` (number): How many matched in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "people": [
    {
      "currentPositions": [
        {
          "companyId": "MergedCompany-5a1d839824000024005e2b09",
          "companyInfo": {
            "domain": "acme.com",
            "employeeRange": "51-200",
            "id": "MergedCompany-5a1d839824000024005e2b09",
            "industry": "Computer Software",
            "linkedinUrl": "https://www.linkedin.com/company/acme",
            "locationInfo": {
              "areaLevel1": "Texas",
              "city": "Austin",
              "country": "United States"
            },
            "name": "Acme",
            "numberOfEmployees": 180,
            "revenueRange": {
              "description": "$10M - $50M",
              "end": 50000000,
              "start": 10000000
            }
          },
          "dateRange": {
            "end": "",
            "start": "2024-03-01T00:00:00Z"
          },
          "emails": [
            {
              "status": "Verified",
              "type": "WorkEmail",
              "value": "jo.bloggs@acme.com"
            }
          ],
          "function": "Sales",
          "phones": [
            {
              "type": "WorkMobile",
              "value": "+1 512 555 0100",
              "verificationStatus": "LikelyAccurate"
            }
          ],
          "seniority": "VP",
          "title": "VP of Sales"
        }
      ],
      "id": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
      "linkedin": {
        "linkedinId": "jobloggs",
        "linkedinUrl": "https://www.linkedin.com/in/jobloggs"
      },
      "location": {
        "areaLevel1": "Texas",
        "city": "Austin",
        "country": "United States",
        "countryCode2": "US"
      },
      "name": {
        "first": "Jo",
        "fullName": "Jo Bloggs",
        "last": "Bloggs",
        "middle": ""
      },
      "personalEmails": [
        {
          "status": "Verified",
          "type": "PersonalEmail",
          "value": "jo@example.com"
        }
      ],
      "personalPhones": [
        {
          "type": "PersonalMobile",
          "value": "+1 512 555 0100",
          "verificationStatus": "LikelyAccurate"
        }
      ],
      "updatedAt": "2026-10-01T09:00:00Z"
    }
  ],
  "total_results": 1
}
```

### Find companies

Build an account list: companies matching industry, size, location, technology or hiring, with how many matching people each has, one page at a time. Spends 3 credits a company (and more for any people included), and is never retried once it may have reached LeadIQ.

**Inputs**

- Job titles (`titles`, list): People with any of these job titles.
- Seniority (`seniorities`, list): People at any of these levels. One or more of: `Executive`, `VP`, `Director`, `Manager`, `SeniorIndividualContributor` (Senior individual contributor), `Other`.
- Roles (`roles`, list): People in any of these functions, such as Sales, Marketing or Engineering.
- Industries (`industries`, list): Companies in any of these industries, as LeadIQ names them.
- Fewest employees (`min_employees`, number): Companies with at least this many employees. From 0 to 10000000.
- Most employees (`max_employees`, number): Companies with at most this many employees. From 0 to 10000000.
- Company country (`company_country`, text): Companies based in this country, such as United States.
- Company state or region (`company_state`, text): Companies based in this state or region, such as California.
- Person's country (`person_country`, text): People located in this country.
- Person's state or region (`person_state`, text): People located in this state or region.
- Person's city (`person_city`, text): People located in this city.
- Company names (`company_names`, list): Only these companies, by name.
- Company domains (`company_domains`, list): Only these companies, by website domain.
- Technologies used (`technologies`, list): Companies using any of these technologies (find exact names with 'Suggest technologies').
- Technology categories (`technology_categories`, list): Companies using technology in any of these categories.
- Hiring for job titles containing (`hiring_titles`, list): Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
- Hiring for skills (`hiring_skills`, list): Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
- Has a work email (`work_email_statuses`, list): Only people with a work email of one of these kinds. One or more of: `Verified`, `VerifiedLikely` (Likely verified).
- People per company (`people_per_company`, number): Also return up to this many matching people at each company, which spends more credits. Leave empty for none. From 0 to 100.
- Order (`sort`, text): How to order the companies. One of: `SizeDesc` (Largest first), `SizeAsc` (Smallest first), `NameAsc` (Name, A to Z), `NameDesc` (Name, Z to A), `IndustryAsc` (Industry, A to Z).
- How many (`limit`, number): How many to return on this page, 1 to 100. Defaults to 25. From 1 to 100.
- Next page (`next_cursor`, text): The next_cursor from an earlier run with the same filters, to get the page after it.

**Outputs**

- `companies` (list): The companies on this page
- `count` (number): How many are on this page
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end
- `total_companies` (number): About how many match in all (first page only, else 0)

**Example output**

```json
{
  "companies": [
    {
      "city": "Austin",
      "companyTechnologyCategories": [
        "CRM"
      ],
      "country": "United States",
      "description": "Acme makes software for sales teams.",
      "domain": "acme.com",
      "employeeCount": 180,
      "fundingInfo": {
        "fundingTotalUsd": 42000000,
        "lastFundingOn": "2024-05-01T00:00:00Z",
        "lastFundingType": "Series B"
      },
      "id": "MergedCompany-5a1d839824000024005e2b09",
      "industry": "Computer Software",
      "linkedinId": "1234567",
      "naicsCode": {
        "code": "511210",
        "description": "Software Publishers"
      },
      "name": "Acme",
      "people": [
        {
          "city": "Austin",
          "company": {
            "city": "Austin",
            "companyTechnologyCategories": [
              "CRM"
            ],
            "country": "United States",
            "description": "Acme makes software for sales teams.",
            "domain": "acme.com",
            "employeeCount": 180,
            "fundingInfo": {
              "fundingTotalUsd": 42000000,
              "lastFundingOn": "2024-05-01T00:00:00Z",
              "lastFundingType": "Series B"
            },
            "id": "MergedCompany-5a1d839824000024005e2b09",
            "industry": "Computer Software",
            "linkedinId": "1234567",
            "naicsCode": {
              "code": "511210",
              "description": "Software Publishers"
            },
            "name": "Acme",
            "revenueRange": {
              "description": "$10M - $50M",
              "end": 50000000,
              "start": 10000000
            },
            "state": "Texas"
          },
          "companyId": "MergedCompany-5a1d839824000024005e2b09",
          "country": "United States",
          "currentPositionStartDate": "2024-03-01T00:00:00Z",
          "firstName": "Jo",
          "id": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
          "lastName": "Bloggs",
          "linkedinId": "jobloggs",
          "linkedinUrl": "https://www.linkedin.com/in/jobloggs",
          "name": "Jo Bloggs",
          "personJobChange": {
            "currentPosition": {
              "companyId": "MergedCompany-5a1d839824000024005e2b09",
              "role": "Sales",
              "seniority": "VP",
              "title": "VP of Sales"
            },
            "jobChangeType": "TitleChange",
            "previousPosition": {
              "companyId": "MergedCompany-5a1d839824000024005e2b09",
              "role": "Sales",
              "seniority": "VP",
              "title": "Sales Director"
            },
            "startedAt": "2024-03-01T00:00:00Z"
          },
          "picture": "https://example.com/jo.png",
          "role": "Sales",
          "seniority": "VP",
          "state": "Texas",
          "title": "VP of Sales",
          "updatedAt": "2026-10-01T09:00:00Z"
        }
      ],
      "revenueRange": {
        "description": "$10M - $50M",
        "end": 50000000,
        "start": 10000000
      },
      "state": "Texas",
      "totalContactsInCompany": 4
    }
  ],
  "count": 1,
  "next_cursor": "[{\"key\":\"personSeniority\",\"value\":\"5\"},{\"key\":\"personId\",\"value\":\"PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f\"}]",
  "total_companies": 310
}
```

### Find people

Prospect for people by job title, seniority, role, industry, company size, location, technology, hiring, or a recent job change, one page at a time. Spends credits for each person returned (and 3 per company when company details are included), and is never retried once it may have reached LeadIQ.

**Inputs**

- Job titles (`titles`, list): People with any of these job titles.
- Seniority (`seniorities`, list): People at any of these levels. One or more of: `Executive`, `VP`, `Director`, `Manager`, `SeniorIndividualContributor` (Senior individual contributor), `Other`.
- Roles (`roles`, list): People in any of these functions, such as Sales, Marketing or Engineering.
- Industries (`industries`, list): Companies in any of these industries, as LeadIQ names them.
- Fewest employees (`min_employees`, number): Companies with at least this many employees. From 0 to 10000000.
- Most employees (`max_employees`, number): Companies with at most this many employees. From 0 to 10000000.
- Company country (`company_country`, text): Companies based in this country, such as United States.
- Company state or region (`company_state`, text): Companies based in this state or region, such as California.
- Person's country (`person_country`, text): People located in this country.
- Person's state or region (`person_state`, text): People located in this state or region.
- Person's city (`person_city`, text): People located in this city.
- Company names (`company_names`, list): Only these companies, by name.
- Company domains (`company_domains`, list): Only these companies, by website domain.
- Technologies used (`technologies`, list): Companies using any of these technologies (find exact names with 'Suggest technologies').
- Technology categories (`technology_categories`, list): Companies using technology in any of these categories.
- Hiring for job titles containing (`hiring_titles`, list): Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
- Hiring for skills (`hiring_skills`, list): Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
- Has a work email (`work_email_statuses`, list): Only people with a work email of one of these kinds. One or more of: `Verified`, `VerifiedLikely` (Likely verified).
- Recent job change (`job_change`, text): Only people who recently changed company or title. One of: `JobChange` (Changed company), `TitleChange` (Changed title (promotion)).
- Include company details (`include_company`, true/false): Also get each person's company details, 3 credits a company. Off by default.
- Order (`sort`, text): How to order the people. One of: `SeniorityDesc` (Most senior first), `SeniorityAsc` (Least senior first), `NameAsc` (Name, A to Z), `NameDesc` (Name, Z to A), `TitleAsc` (Title, A to Z), `UpdatedAtDesc` (Recently updated first), `JobChangeStartedAtDesc` (Most recent job change first).
- How many (`limit`, number): How many to return on this page, 1 to 100. Defaults to 25. From 1 to 100.
- Next page (`next_cursor`, text): The next_cursor from an earlier run with the same filters, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end
- `people` (list): The people on this page
- `total_people` (number): About how many match in all (first page only, else 0)

**Example output**

```json
{
  "count": 1,
  "next_cursor": "[{\"key\":\"personSeniority\",\"value\":\"5\"},{\"key\":\"personId\",\"value\":\"PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f\"}]",
  "people": [
    {
      "city": "Austin",
      "company": {
        "city": "Austin",
        "companyTechnologyCategories": [
          "CRM"
        ],
        "country": "United States",
        "description": "Acme makes software for sales teams.",
        "domain": "acme.com",
        "employeeCount": 180,
        "fundingInfo": {
          "fundingTotalUsd": 42000000,
          "lastFundingOn": "2024-05-01T00:00:00Z",
          "lastFundingType": "Series B"
        },
        "id": "MergedCompany-5a1d839824000024005e2b09",
        "industry": "Computer Software",
        "linkedinId": "1234567",
        "naicsCode": {
          "code": "511210",
          "description": "Software Publishers"
        },
        "name": "Acme",
        "revenueRange": {
          "description": "$10M - $50M",
          "end": 50000000,
          "start": 10000000
        },
        "state": "Texas"
      },
      "companyId": "MergedCompany-5a1d839824000024005e2b09",
      "country": "United States",
      "currentPositionStartDate": "2024-03-01T00:00:00Z",
      "firstName": "Jo",
      "id": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
      "lastName": "Bloggs",
      "linkedinId": "jobloggs",
      "linkedinUrl": "https://www.linkedin.com/in/jobloggs",
      "name": "Jo Bloggs",
      "personJobChange": {
        "currentPosition": {
          "companyId": "MergedCompany-5a1d839824000024005e2b09",
          "role": "Sales",
          "seniority": "VP",
          "title": "VP of Sales"
        },
        "jobChangeType": "TitleChange",
        "previousPosition": {
          "companyId": "MergedCompany-5a1d839824000024005e2b09",
          "role": "Sales",
          "seniority": "VP",
          "title": "Sales Director"
        },
        "startedAt": "2024-03-01T00:00:00Z"
      },
      "picture": "https://example.com/jo.png",
      "role": "Sales",
      "seniority": "VP",
      "state": "Texas",
      "title": "VP of Sales",
      "updatedAt": "2026-10-01T09:00:00Z"
    }
  ],
  "total_people": 1240
}
```

### Get account and credits

Get your LeadIQ plans with the credits used and left this billing period. Free.

**Inputs**: None.

**Outputs**

- `account` (object): Your plans and credits

**Example output**

```json
{
  "account": {
    "dataHubPlan": {
      "available": 1000,
      "name": "Data Hub",
      "nextBillingPeriod": "2026-12-01T00:00:00Z",
      "product": "DataHub",
      "status": "Active",
      "used": 0
    },
    "plans": [
      {
        "name": "Enterprise Annual",
        "nextBillingPeriod": "2026-12-01T00:00:00Z",
        "product": "Universal",
        "status": "Active"
      }
    ],
    "universalPlan": {
      "available": 4200,
      "name": "Enterprise Annual",
      "nextBillingPeriod": "2026-12-01T00:00:00Z",
      "product": "Universal",
      "status": "Active",
      "used": 800
    }
  }
}
```

### Get company list

Get a company list with one page of the companies saved in it, newest first. Free.

**Inputs**

- Company list (`company_list_id`, text, required): The company list. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. LeadIQ's default is 25. From 1 to 100.
- Next page (`cursor`, text): The next_cursor from an earlier page, to get the page after it.

**Outputs**

- `companies` (list): The companies in it, on this page
- `company_list` (object): The company list
- `count` (number): How many are on this page
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end

**Example output**

```json
{
  "companies": [
    {
      "companyId": "MergedCompany-5a1d839824000024005e2b09",
      "createdAt": "2026-10-01T09:00:00Z",
      "domain": "acme.com",
      "id": "65a1b2c3d4e5f6a7b8c9d0e2",
      "linkedinUrl": "https://www.linkedin.com/company/acme",
      "name": "Acme",
      "notes": "Strong fit",
      "updatedAt": "2026-10-01T09:00:00Z"
    }
  ],
  "company_list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Software companies in Texas",
    "id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Target accounts",
    "updatedAt": "2026-10-01T09:00:00Z"
  },
  "count": 1,
  "next_cursor": ""
}
```

### Get phone data health report

See how many phone numbers your reps marked bad in a period, and for how many people LeadIQ has an alternate number. Team admins get the whole company, or one rep's; everyone else their own. Free.

**Inputs**

- Period (`period`, text): The period to cover. Or leave empty and give dates. One of: `LAST_1_MONTH` (Last month), `LAST_3_MONTHS` (Last 3 months), `LAST_6_MONTHS` (Last 6 months), `LAST_12_MONTHS` (Last 12 months).
- From (`since`, date): First day to cover, when no period is chosen.
- To (`until`, date): Last day to cover, when no period is chosen.
- Rep's email (`rep_email`, text): For team admins: one rep's email, for only their numbers.

**Outputs**

- `report` (object): The report

**Example output**

```json
{
  "report": {
    "computedAt": "2026-11-01T09:00:00Z",
    "customerDomain": "acme.com",
    "notices": [],
    "period": {
      "preset": "LAST_3_MONTHS",
      "since": "2026-08-01",
      "until": "2026-10-31"
    },
    "repEmail": "",
    "scope": "COMPANY",
    "sources": [
      "Outreach"
    ],
    "status": "ready",
    "summaries": [
      {
        "badItems": 120,
        "dataPoint": "PHONE",
        "noAlternate": 25,
        "notChecked": 0,
        "otherAlternate": 30,
        "prospects": 110,
        "prospectsFound": 95,
        "prospectsNotFound": 15,
        "verifiedAlternate": 40
      }
    ]
  }
}
```

### Get prospect

Get one saved prospect with their contact details. Free.

**Inputs**

- Prospect ID (`prospect_id`, text, required): The saved prospect's id, from 'Get prospect list' or 'Add prospect to list'.

**Outputs**

- `prospect` (object): The saved prospect

**Example output**

```json
{
  "prospect": {
    "company": {
      "domain": "acme.com",
      "employees": 180,
      "id": "MergedCompany-5a1d839824000024005e2b09",
      "industry": "Computer Software",
      "name": "Acme",
      "phone": "+1 512 555 0199"
    },
    "createdAt": "2026-10-01T09:00:00Z",
    "emailStatus": "Verified",
    "firstName": "Jo",
    "function": "Sales",
    "id": "64f1c2a9e4b0a1b2c3d4e5f7",
    "lastName": "Bloggs",
    "linkedinId": "jobloggs",
    "linkedinUrl": "https://www.linkedin.com/in/jobloggs",
    "listIds": [
      "64f1c2a9e4b0a1b2c3d4e5f6"
    ],
    "location": {
      "city": "Austin",
      "country": "United States",
      "formatted": "100 Congress Ave, Austin, TX 78701, United States",
      "state": "Texas",
      "streetLine1": "100 Congress Ave",
      "streetLine2": "",
      "zip": "78701"
    },
    "mobilePhones": [
      {
        "status": "Verified",
        "value": "+1 512 555 0100"
      }
    ],
    "name": "Jo Bloggs",
    "notes": "Met at SaaStr",
    "personId": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
    "personalEmails": [
      "jo@example.com"
    ],
    "picture": "https://example.com/jo.png",
    "seniority": "VP",
    "title": "VP of Sales",
    "updatedAt": "2026-10-01T09:00:00Z",
    "workEmail": "jo.bloggs@acme.com"
  }
}
```

### Get prospect list

Get a prospect list with one page of the people saved in it, with their contact details. Free.

**Inputs**

- Prospect list (`list_id`, text, required): The prospect list. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. LeadIQ's default is 25. From 1 to 100.
- Next page (`cursor`, text): The next_cursor from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `list` (object): The prospect list
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end
- `prospects` (list): The people saved in it, on this page

**Example output**

```json
{
  "count": 1,
  "list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Sales leaders in Texas",
    "endDate": "2026-09-30",
    "id": "64f1c2a9e4b0a1b2c3d4e5f6",
    "name": "Q3 Outbound",
    "startDate": "2026-07-01",
    "status": "Active",
    "updatedAt": "2026-10-01T09:00:00Z",
    "visibility": "Private"
  },
  "next_cursor": "",
  "prospects": [
    {
      "company": {
        "domain": "acme.com",
        "employees": 180,
        "id": "MergedCompany-5a1d839824000024005e2b09",
        "industry": "Computer Software",
        "name": "Acme",
        "phone": "+1 512 555 0199"
      },
      "createdAt": "2026-10-01T09:00:00Z",
      "emailStatus": "Verified",
      "firstName": "Jo",
      "function": "Sales",
      "id": "64f1c2a9e4b0a1b2c3d4e5f7",
      "lastName": "Bloggs",
      "linkedinId": "jobloggs",
      "linkedinUrl": "https://www.linkedin.com/in/jobloggs",
      "listIds": [
        "64f1c2a9e4b0a1b2c3d4e5f6"
      ],
      "location": {
        "city": "Austin",
        "country": "United States",
        "formatted": "100 Congress Ave, Austin, TX 78701, United States",
        "state": "Texas",
        "streetLine1": "100 Congress Ave",
        "streetLine2": "",
        "zip": "78701"
      },
      "mobilePhones": [
        {
          "status": "Verified",
          "value": "+1 512 555 0100"
        }
      ],
      "name": "Jo Bloggs",
      "notes": "Met at SaaStr",
      "personId": "PersonID-4d3e379c-3f40-4f90-b436-af9bf628f32f",
      "personalEmails": [
        "jo@example.com"
      ],
      "picture": "https://example.com/jo.png",
      "seniority": "VP",
      "title": "VP of Sales",
      "updatedAt": "2026-10-01T09:00:00Z",
      "workEmail": "jo.bloggs@acme.com"
    }
  ]
}
```

### List company lists

List your saved company lists, one page at a time; run it again with the next page it gives to see more. Free.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. LeadIQ's default is 25. From 1 to 100.
- Next page (`cursor`, text): The next_cursor from an earlier page, to get the page after it.

**Outputs**

- `company_lists` (list): The company lists
- `count` (number): How many are on this page
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end

**Example output**

```json
{
  "company_lists": [
    {
      "createdAt": "2026-07-01T09:00:00Z",
      "description": "Software companies in Texas",
      "id": "65a1b2c3d4e5f6a7b8c9d0e1",
      "name": "Target accounts",
      "updatedAt": "2026-10-01T09:00:00Z"
    }
  ],
  "count": 1,
  "next_cursor": ""
}
```

### List prospect lists

List your saved prospect lists, one page at a time; run it again with the next page it gives to see more. Free.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. LeadIQ's default is 25. From 1 to 100.
- Next page (`cursor`, text): The next_cursor from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `lists` (list): The prospect lists
- `next_cursor` (text): Give this to the same step to get the next page; empty at the end

**Example output**

```json
{
  "count": 1,
  "lists": [
    {
      "createdAt": "2026-07-01T09:00:00Z",
      "description": "Sales leaders in Texas",
      "endDate": "2026-09-30",
      "id": "64f1c2a9e4b0a1b2c3d4e5f6",
      "name": "Q3 Outbound",
      "startDate": "2026-07-01",
      "status": "Active",
      "updatedAt": "2026-10-01T09:00:00Z",
      "visibility": "Private"
    }
  ],
  "next_cursor": ""
}
```

### Remove company from company list

Remove one company from a company list. Free. It can be added again later.

**Inputs**

- Company list (`company_list_id`, text, required): The company list. Pick one, or give its id from an earlier step.
- Entry ID (`entry_id`, text, required): The company's entry id in the list, from 'Get company list' (not its LeadIQ company id).

**Outputs**

- `entry` (object): The entry removed
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "entry": {
    "companyId": "MergedCompany-5a1d839824000024005e2b09",
    "createdAt": "2026-10-01T09:00:00Z",
    "domain": "acme.com",
    "id": "65a1b2c3d4e5f6a7b8c9d0e2",
    "linkedinUrl": "https://www.linkedin.com/company/acme",
    "name": "Acme",
    "notes": "Strong fit",
    "updatedAt": "2026-10-01T09:00:00Z"
  },
  "removed": true
}
```

### Report contact data

Tell LeadIQ an email or phone number it gave you is wrong (it bounced, or belongs to someone else) or right, so it can correct its data. Free.

**Inputs**

- Email or phone (`value`, text, required): The email address or phone number you are reporting.
- It is (`status`, text): Whether the detail is wrong or right. One of: `Invalid` (Wrong (bounced, disconnected or someone else's)), `Correct`.
- Why it's wrong (`invalid_reason`, text): What happened, when it is wrong. One of: `WrongPerson` (Belongs to someone else), `EmailBounceCode511` (Email bounced: mailbox doesn't exist (5.1.1)), `EmailBounceCode521` (Email bounced: mailbox disabled (5.2.1)), `EmailBounceCode522` (Email bounced: mailbox full (5.2.2)), `EmailBounceCode516` (Email bounced: mailbox has moved (5.1.6)), `EmailBounceCode571` (Email bounced: delivery refused (5.7.1)), `EmailBounceCode500` (Email bounced: other reason (5.0.0)), `Other`.
- Kind of detail (`contact_type`, text): What kind of email or phone it is. One of: `WorkEmail` (Work email), `PersonalEmail` (Personal email), `WorkPhone` (Work phone), `WorkMobile` (Work mobile), `WorkHQ` (Company headquarters phone), `WorkBranch` (Company branch phone), `PersonalPhone` (Personal phone), `PersonalMobile` (Personal mobile), `PersonalLandline` (Personal landline), `Fax`.
- Person's name (`name`, text): Whose detail it is.
- LinkedIn profile (`linkedin_url`, text): Their LinkedIn profile.
- LeadIQ person ID (`person_id`, text): Their LeadIQ id, from a search.
- Company (`company_name`, text): Where they work.
- Company domain (`company_domain`, text): Their employer's website domain.
- Job title (`title`, text): Their job title.

**Outputs**

- `feedback_id` (text): LeadIQ's id for the feedback
- `submitted` (true/false): Always true once sent

**Example output**

```json
{
  "feedback_id": "fb_01HXAMPLE",
  "submitted": true
}
```

### Suggest hiring skills

Find the exact skills and tools named in open job postings that start with some words, with how many open jobs and companies each has. Free.

**Inputs**

- Starts with (`search_text`, text, required): The start of the words to look for, such as data eng.
- How many (`limit`, number): How many to return, 1 to 50. Defaults to 10. From 1 to 50.

**Outputs**

- `count` (number): How many are on this page
- `suggestions` (list): The matches, most hiring companies first

**Example output**

```json
{
  "count": 1,
  "suggestions": [
    {
      "companies": 2100,
      "openJobs": 5400,
      "value": "Python"
    }
  ]
}
```

### Suggest hiring titles

Find the exact job titles companies are hiring for that start with some words, with how many open jobs and companies each has. Free.

**Inputs**

- Starts with (`search_text`, text, required): The start of the words to look for, such as data eng.
- How many (`limit`, number): How many to return, 1 to 50. Defaults to 10. From 1 to 50.

**Outputs**

- `count` (number): How many are on this page
- `suggestions` (list): The matches, most hiring companies first

**Example output**

```json
{
  "count": 1,
  "suggestions": [
    {
      "companies": 940,
      "openJobs": 1820,
      "value": "senior data engineer"
    }
  ]
}
```

### Suggest technologies

Find up to 10 exact technology names that start with some words, most used first, for the technology filter of the searches. Free.

**Inputs**

- Starts with (`search_text`, text, required): The start of the words to look for, such as data eng.

**Outputs**

- `count` (number): How many are on this page
- `technologies` (list): Technology names, most used first

**Example output**

```json
{
  "count": 2,
  "technologies": [
    "Salesforce",
    "Salesloft"
  ]
}
```

### Update company list

Rename a company list or change its description. Fields left empty keep their value, and the companies in it are untouched. Free.

**Inputs**

- Company list (`company_list_id`, text, required): The company list. Pick one, or give its id from an earlier step.
- New name (`name`, text): A new name. Leave empty to keep it.
- New description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `company_list` (object): The company list

**Example output**

```json
{
  "company_list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Software companies in Texas",
    "id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Target accounts",
    "updatedAt": "2026-10-01T09:00:00Z"
  }
}
```
