LeadIQ

App · 22 actions

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.

Actions

ActionWhat it does
Add companies to company listSave a company, or up to 100 from an earlier step, into a company list.
Add prospect to listSave a person into a prospect list with the details you have, such as from 'Find a person'.
Create company listCreate a company list.
Create prospect listCreate a prospect list to save people into.
Delete company listDelete a company list you own and the entries in it.
Find a companyLook up a company by website domain, name or LinkedIn page, with its size, industry, revenue, funding, location and technologies.
Find a personFind someone you already know of, by LinkedIn profile, email, or name and company, with their job, LinkedIn and the contact details you choose.
Find companiesBuild an account list: companies matching industry, size, location, technology or hiring, with how many matching people each has, one page at a time.
Find peopleProspect for people by job title, seniority, role, industry, company size, location, technology, hiring, or a recent job change, one page at a time.
Get account and creditsGet your LeadIQ plans with the credits used and left this billing period.
Get company listGet a company list with one page of the companies saved in it, newest first.
Get phone data health reportSee how many phone numbers your reps marked bad in a period, and for how many people LeadIQ has an alternate number.
Get prospectGet one saved prospect with their contact details.
Get prospect listGet a prospect list with one page of the people saved in it, with their contact details.
List company listsList your saved company lists, one page at a time; run it again with the next page it gives to see more.
List prospect listsList your saved prospect lists, one page at a time; run it again with the next page it gives to see more.
Remove company from company listRemove one company from a company list.
Report contact dataTell 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.
Suggest hiring skillsFind the exact skills and tools named in open job postings that start with some words, with how many open jobs and companies each has.
Suggest hiring titlesFind the exact job titles companies are hiring for that start with some words, with how many open jobs and companies each has.
Suggest technologiesFind up to 10 exact technology names that start with some words, most used first, for the technology filter of the searches.
Update company listRename a company list or change its description.

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 listcompany_list_idtextRequired
The company list. Pick one, or give its id from an earlier step.
Website domaindomaintext
The company's domain, such as acme.com.
Namenametext
The company's name.
LeadIQ company IDcompany_idtext
The company's LeadIQ id, from a search: the best match.
LinkedIn pagelinkedin_urltext
The company's LinkedIn page.
Notesnotestext
Your notes on the company.
More companiescompanieslist
A list of companies from an earlier step, such as 'Find companies', each with an id, companyId, name, domain or linkedinUrl.

Outputs

countnumber
How many were saved
creatednumber
How many were new to the list
failedlist
Companies that couldn't be saved
succeededlist
The entries saved
updatednumber
How many were already there and updated
Example output
{
  "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 listlist_idtextRequired
The prospect list. Pick one, or give its id from an earlier step.
First namefirst_nametextRequired
The person's first name.
Last namelast_nametextRequired
The person's last name.
Work emailwork_emailtext
Their work email address.
Email statusemail_statustext
How sure you are of the work email. Leave empty if you don't know.One of: Verified, VerifiedLikely (Likely verified), Unverified.
Phonephonetext
Their mobile phone number.
Job titletitletext
Their job title.
Senioritysenioritytext
Their level. Choose Other if none fits.One of: Executive, VP, Director, Manager, SeniorIndividualContributor (Senior individual contributor), Other.
Companycompanytext
Their employer's name.
Company domaincompany_domaintext
Their employer's website domain.
LinkedIn profilelinkedin_urltext
Their LinkedIn profile address.
LeadIQ person IDperson_idtext
Their LeadIQ person id, from 'Find a person' or 'Find people'.
LeadIQ company IDcompany_idtext
Their employer's LeadIQ id, from a search, so the company is saved once.
Job functionjob_functiontext
Their function, such as Sales.
Company industrycompany_industrytext
Their employer's industry.
Citycitytext
The city they are in.
State or regionstatetext
The state or region they are in.
Countrycountrytext
The country they are in.
Notesnotestext
Your notes on them, up to 5,000 characters.

Outputs

prospectobject
The saved prospect
Example output
{
  "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

NamenametextRequired
The list's name, different from your other company lists.
Descriptiondescriptiontext
What the list is for.

Outputs

company_listobject
The company list
Example output
{
  "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

NamenametextRequired
The list's name.
Descriptiondescriptiontext
What the list is for.

Outputs

listobject
The prospect list
Example output
{
  "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 listcompany_list_idtextRequired
The company list. Pick one, or give its id from an earlier step.

Outputs

company_listobject
The list deleted
deletedtrue/false
Always true once deleted
Example output
{
  "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 domaindomaintext
The company's domain, such as acme.com.
Namenametext
The company's name.
LinkedIn pagelinkedin_urltext
The company's LinkedIn page.
LeadIQ company IDcompany_idtext
The company's LeadIQ id, from a search.
Exact match onlystricttrue/false
Only return a company matching everything given. Off by default.

Outputs

companieslist
The companies matched, best first
countnumber
How many are on this page
has_moretrue/false
Whether more matched than were returned
total_resultsnumber
How many matched in all
Example output
{
  "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 profilelinkedin_urltext
Their LinkedIn profile address: the surest match.
Emailemailtext
An email address of theirs.
First namefirst_nametext
Their first name.
Last namelast_nametext
Their last name.
Companycompany_nametext
Where they work, by name.
Company domaincompany_domaintext
Where they work, by website domain, such as acme.com.
Includeincludelist
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 IDperson_idtext
Their LeadIQ id, from a search.
Matcheslimitnumber
How many possible matches to return, 1 to 10. Defaults to 1.From 1 to 10.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether more matched than were returned
peoplelist
The people matched, best first
total_resultsnumber
How many matched in all
Example output
{
  "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 titlestitleslist
People with any of these job titles.
Senioritysenioritieslist
People at any of these levels.One or more of: Executive, VP, Director, Manager, SeniorIndividualContributor (Senior individual contributor), Other.
Rolesroleslist
People in any of these functions, such as Sales, Marketing or Engineering.
Industriesindustrieslist
Companies in any of these industries, as LeadIQ names them.
Fewest employeesmin_employeesnumber
Companies with at least this many employees.From 0 to 10000000.
Most employeesmax_employeesnumber
Companies with at most this many employees.From 0 to 10000000.
Company countrycompany_countrytext
Companies based in this country, such as United States.
Company state or regioncompany_statetext
Companies based in this state or region, such as California.
Person's countryperson_countrytext
People located in this country.
Person's state or regionperson_statetext
People located in this state or region.
Person's cityperson_citytext
People located in this city.
Company namescompany_nameslist
Only these companies, by name.
Company domainscompany_domainslist
Only these companies, by website domain.
Technologies usedtechnologieslist
Companies using any of these technologies (find exact names with 'Suggest technologies').
Technology categoriestechnology_categorieslist
Companies using technology in any of these categories.
Hiring for job titles containinghiring_titleslist
Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
Hiring for skillshiring_skillslist
Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
Has a work emailwork_email_statuseslist
Only people with a work email of one of these kinds.One or more of: Verified, VerifiedLikely (Likely verified).
People per companypeople_per_companynumber
Also return up to this many matching people at each company, which spends more credits. Leave empty for none.From 0 to 100.
Ordersorttext
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 manylimitnumber
How many to return on this page, 1 to 100. Defaults to 25.From 1 to 100.
Next pagenext_cursortext
The next_cursor from an earlier run with the same filters, to get the page after it.

Outputs

companieslist
The companies on this page
countnumber
How many are on this page
next_cursortext
Give this to the same step to get the next page; empty at the end
total_companiesnumber
About how many match in all (first page only, else 0)
Example output
{
  "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 titlestitleslist
People with any of these job titles.
Senioritysenioritieslist
People at any of these levels.One or more of: Executive, VP, Director, Manager, SeniorIndividualContributor (Senior individual contributor), Other.
Rolesroleslist
People in any of these functions, such as Sales, Marketing or Engineering.
Industriesindustrieslist
Companies in any of these industries, as LeadIQ names them.
Fewest employeesmin_employeesnumber
Companies with at least this many employees.From 0 to 10000000.
Most employeesmax_employeesnumber
Companies with at most this many employees.From 0 to 10000000.
Company countrycompany_countrytext
Companies based in this country, such as United States.
Company state or regioncompany_statetext
Companies based in this state or region, such as California.
Person's countryperson_countrytext
People located in this country.
Person's state or regionperson_statetext
People located in this state or region.
Person's cityperson_citytext
People located in this city.
Company namescompany_nameslist
Only these companies, by name.
Company domainscompany_domainslist
Only these companies, by website domain.
Technologies usedtechnologieslist
Companies using any of these technologies (find exact names with 'Suggest technologies').
Technology categoriestechnology_categorieslist
Companies using technology in any of these categories.
Hiring for job titles containinghiring_titleslist
Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
Hiring for skillshiring_skillslist
Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
Has a work emailwork_email_statuseslist
Only people with a work email of one of these kinds.One or more of: Verified, VerifiedLikely (Likely verified).
Recent job changejob_changetext
Only people who recently changed company or title.One of: JobChange (Changed company), TitleChange (Changed title (promotion)).
Include company detailsinclude_companytrue/false
Also get each person's company details, 3 credits a company. Off by default.
Ordersorttext
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 manylimitnumber
How many to return on this page, 1 to 100. Defaults to 25.From 1 to 100.
Next pagenext_cursortext
The next_cursor from an earlier run with the same filters, to get the page after it.

Outputs

countnumber
How many are on this page
next_cursortext
Give this to the same step to get the next page; empty at the end
peoplelist
The people on this page
total_peoplenumber
About how many match in all (first page only, else 0)
Example output
{
  "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

accountobject
Your plans and credits
Example output
{
  "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 listcompany_list_idtextRequired
The company list. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
Next pagecursortext
The next_cursor from an earlier page, to get the page after it.

Outputs

companieslist
The companies in it, on this page
company_listobject
The company list
countnumber
How many are on this page
next_cursortext
Give this to the same step to get the next page; empty at the end
Example output
{
  "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

Periodperiodtext
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).
Fromsincedate
First day to cover, when no period is chosen.
Tountildate
Last day to cover, when no period is chosen.
Rep's emailrep_emailtext
For team admins: one rep's email, for only their numbers.

Outputs

reportobject
The report
Example output
{
  "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 IDprospect_idtextRequired
The saved prospect's id, from 'Get prospect list' or 'Add prospect to list'.

Outputs

prospectobject
The saved prospect
Example output
{
  "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 listlist_idtextRequired
The prospect list. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
Next pagecursortext
The next_cursor from an earlier page, to get the page after it.

Outputs

countnumber
How many are on this page
listobject
The prospect list
next_cursortext
Give this to the same step to get the next page; empty at the end
prospectslist
The people saved in it, on this page
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
Next pagecursortext
The next_cursor from an earlier page, to get the page after it.

Outputs

company_listslist
The company lists
countnumber
How many are on this page
next_cursortext
Give this to the same step to get the next page; empty at the end
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
Next pagecursortext
The next_cursor from an earlier page, to get the page after it.

Outputs

countnumber
How many are on this page
listslist
The prospect lists
next_cursortext
Give this to the same step to get the next page; empty at the end
Example output
{
  "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 listcompany_list_idtextRequired
The company list. Pick one, or give its id from an earlier step.
Entry IDentry_idtextRequired
The company's entry id in the list, from 'Get company list' (not its LeadIQ company id).

Outputs

entryobject
The entry removed
removedtrue/false
Always true once removed
Example output
{
  "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 phonevaluetextRequired
The email address or phone number you are reporting.
It isstatustext
Whether the detail is wrong or right.One of: Invalid (Wrong (bounced, disconnected or someone else's)), Correct.
Why it's wronginvalid_reasontext
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 detailcontact_typetext
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 namenametext
Whose detail it is.
LinkedIn profilelinkedin_urltext
Their LinkedIn profile.
LeadIQ person IDperson_idtext
Their LeadIQ id, from a search.
Companycompany_nametext
Where they work.
Company domaincompany_domaintext
Their employer's website domain.
Job titletitletext
Their job title.

Outputs

feedback_idtext
LeadIQ's id for the feedback
submittedtrue/false
Always true once sent
Example output
{
  "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 withsearch_texttextRequired
The start of the words to look for, such as data eng.
How manylimitnumber
How many to return, 1 to 50. Defaults to 10.From 1 to 50.

Outputs

countnumber
How many are on this page
suggestionslist
The matches, most hiring companies first
Example output
{
  "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 withsearch_texttextRequired
The start of the words to look for, such as data eng.
How manylimitnumber
How many to return, 1 to 50. Defaults to 10.From 1 to 50.

Outputs

countnumber
How many are on this page
suggestionslist
The matches, most hiring companies first
Example output
{
  "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 withsearch_texttextRequired
The start of the words to look for, such as data eng.

Outputs

countnumber
How many are on this page
technologieslist
Technology names, most used first
Example output
{
  "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 listcompany_list_idtextRequired
The company list. Pick one, or give its id from an earlier step.
New namenametext
A new name. Leave empty to keep it.
New descriptiondescriptiontext
A new description. Leave empty to keep it.

Outputs

company_listobject
The company list
Example output
{
  "company_list": {
    "createdAt": "2026-07-01T09:00:00Z",
    "description": "Software companies in Texas",
    "id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Target accounts",
    "updatedAt": "2026-10-01T09:00:00Z"
  }
}

On this page