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
| Action | What it does |
|---|---|
| Add companies to company list | Save a company, or up to 100 from an earlier step, into a company list. |
| Add prospect to list | Save a person into a prospect list with the details you have, such as from 'Find a person'. |
| Create company list | Create a company list. |
| Create prospect list | Create a prospect list to save people into. |
| Delete company list | Delete a company list you own and the entries in it. |
| Find a company | Look up a company by website domain, name or LinkedIn page, with its size, industry, revenue, funding, location and technologies. |
| 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. |
| 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. |
| 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. |
| Get account and credits | Get your LeadIQ plans with the credits used and left this billing period. |
| Get company list | Get a company list with one page of the companies saved in it, newest first. |
| 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. |
| Get prospect | Get one saved prospect with their contact details. |
| Get prospect list | Get a prospect list with one page of the people saved in it, with their contact details. |
| 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. |
| 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. |
| Remove company from company list | Remove one company from a company list. |
| 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. |
| 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. |
| 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. |
| Suggest technologies | Find up to 10 exact technology names that start with some words, most used first, for the technology filter of the searches. |
| Update company list | Rename 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 list
company_list_idtextRequired - The company list. Pick one, or give its id from an earlier step.
- Website domain
domaintext - The company's domain, such as acme.com.
- Name
nametext - The company's name.
- LeadIQ company ID
company_idtext - The company's LeadIQ id, from a search: the best match.
- LinkedIn page
linkedin_urltext - The company's LinkedIn page.
- Notes
notestext - Your notes on the company.
- More companies
companieslist - 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 list
list_idtextRequired - The prospect list. Pick one, or give its id from an earlier step.
- First name
first_nametextRequired - The person's first name.
- Last name
last_nametextRequired - The person's last name.
- Work email
work_emailtext - Their work email address.
- Email status
email_statustext - How sure you are of the work email. Leave empty if you don't know.One of:
Verified,VerifiedLikely(Likely verified),Unverified. - Phone
phonetext - Their mobile phone number.
- Job title
titletext - Their job title.
- Seniority
senioritytext - Their level. Choose Other if none fits.One of:
Executive,VP,Director,Manager,SeniorIndividualContributor(Senior individual contributor),Other. - Company
companytext - Their employer's name.
- Company domain
company_domaintext - Their employer's website domain.
- LinkedIn profile
linkedin_urltext - Their LinkedIn profile address.
- LeadIQ person ID
person_idtext - Their LeadIQ person id, from 'Find a person' or 'Find people'.
- LeadIQ company ID
company_idtext - Their employer's LeadIQ id, from a search, so the company is saved once.
- Job function
job_functiontext - Their function, such as Sales.
- Company industry
company_industrytext - Their employer's industry.
- City
citytext - The city they are in.
- State or region
statetext - The state or region they are in.
- Country
countrytext - The country they are in.
- Notes
notestext - 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
- Name
nametextRequired - The list's name, different from your other company lists.
- Description
descriptiontext - 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
- Name
nametextRequired - The list's name.
- Description
descriptiontext - 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 list
company_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 domain
domaintext - The company's domain, such as acme.com.
- Name
nametext - The company's name.
- LinkedIn page
linkedin_urltext - The company's LinkedIn page.
- LeadIQ company ID
company_idtext - The company's LeadIQ id, from a search.
- Exact match only
stricttrue/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 profile
linkedin_urltext - Their LinkedIn profile address: the surest match.
- Email
emailtext - An email address of theirs.
- First name
first_nametext - Their first name.
- Last name
last_nametext - Their last name.
- Company
company_nametext - Where they work, by name.
- Company domain
company_domaintext - Where they work, by website domain, such as acme.com.
- Include
includelist - 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_idtext - Their LeadIQ id, from a search.
- Matches
limitnumber - 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 titles
titleslist - People with any of these job titles.
- Seniority
senioritieslist - People at any of these levels.One or more of:
Executive,VP,Director,Manager,SeniorIndividualContributor(Senior individual contributor),Other. - Roles
roleslist - People in any of these functions, such as Sales, Marketing or Engineering.
- Industries
industrieslist - Companies in any of these industries, as LeadIQ names them.
- Fewest employees
min_employeesnumber - Companies with at least this many employees.From 0 to 10000000.
- Most employees
max_employeesnumber - Companies with at most this many employees.From 0 to 10000000.
- Company country
company_countrytext - Companies based in this country, such as United States.
- Company state or region
company_statetext - Companies based in this state or region, such as California.
- Person's country
person_countrytext - People located in this country.
- Person's state or region
person_statetext - People located in this state or region.
- Person's city
person_citytext - People located in this city.
- Company names
company_nameslist - Only these companies, by name.
- Company domains
company_domainslist - Only these companies, by website domain.
- Technologies used
technologieslist - Companies using any of these technologies (find exact names with 'Suggest technologies').
- Technology categories
technology_categorieslist - Companies using technology in any of these categories.
- Hiring for job titles containing
hiring_titleslist - Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
- Hiring for skills
hiring_skillslist - Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
- Has a work email
work_email_statuseslist - Only people with a work email of one of these kinds.One or more of:
Verified,VerifiedLikely(Likely verified). - People per company
people_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.
- Order
sorttext - 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
limitnumber - How many to return on this page, 1 to 100. Defaults to 25.From 1 to 100.
- Next page
next_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 titles
titleslist - People with any of these job titles.
- Seniority
senioritieslist - People at any of these levels.One or more of:
Executive,VP,Director,Manager,SeniorIndividualContributor(Senior individual contributor),Other. - Roles
roleslist - People in any of these functions, such as Sales, Marketing or Engineering.
- Industries
industrieslist - Companies in any of these industries, as LeadIQ names them.
- Fewest employees
min_employeesnumber - Companies with at least this many employees.From 0 to 10000000.
- Most employees
max_employeesnumber - Companies with at most this many employees.From 0 to 10000000.
- Company country
company_countrytext - Companies based in this country, such as United States.
- Company state or region
company_statetext - Companies based in this state or region, such as California.
- Person's country
person_countrytext - People located in this country.
- Person's state or region
person_statetext - People located in this state or region.
- Person's city
person_citytext - People located in this city.
- Company names
company_nameslist - Only these companies, by name.
- Company domains
company_domainslist - Only these companies, by website domain.
- Technologies used
technologieslist - Companies using any of these technologies (find exact names with 'Suggest technologies').
- Technology categories
technology_categorieslist - Companies using technology in any of these categories.
- Hiring for job titles containing
hiring_titleslist - Companies with an open job whose title contains any of these words. Hiring search is rolling out by account.
- Hiring for skills
hiring_skillslist - Companies with an open job naming any of these skills (find exact names with 'Suggest hiring skills').
- Has a work email
work_email_statuseslist - Only people with a work email of one of these kinds.One or more of:
Verified,VerifiedLikely(Likely verified). - Recent job change
job_changetext - Only people who recently changed company or title.One of:
JobChange(Changed company),TitleChange(Changed title (promotion)). - Include company details
include_companytrue/false - Also get each person's company details, 3 credits a company. Off by default.
- Order
sorttext - 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
limitnumber - How many to return on this page, 1 to 100. Defaults to 25.From 1 to 100.
- Next page
next_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 list
company_list_idtextRequired - The company list. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
- Next page
cursortext - 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
- Period
periodtext - 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
sincedate - First day to cover, when no period is chosen.
- To
untildate - Last day to cover, when no period is chosen.
- Rep's email
rep_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 ID
prospect_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 list
list_idtextRequired - The prospect list. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
- Next page
cursortext - 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 size
limitnumber - How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
- Next page
cursortext - 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 size
limitnumber - How many to return, 1 to 100. LeadIQ's default is 25.From 1 to 100.
- Next page
cursortext - 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 list
company_list_idtextRequired - The company list. Pick one, or give its id from an earlier step.
- Entry ID
entry_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 phone
valuetextRequired - The email address or phone number you are reporting.
- It is
statustext - Whether the detail is wrong or right.One of:
Invalid(Wrong (bounced, disconnected or someone else's)),Correct. - Why it's wrong
invalid_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 detail
contact_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 name
nametext - Whose detail it is.
- LinkedIn profile
linkedin_urltext - Their LinkedIn profile.
- LeadIQ person ID
person_idtext - Their LeadIQ id, from a search.
- Company
company_nametext - Where they work.
- Company domain
company_domaintext - Their employer's website domain.
- Job title
titletext - 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 with
search_texttextRequired - The start of the words to look for, such as data eng.
- How many
limitnumber - 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 with
search_texttextRequired - The start of the words to look for, such as data eng.
- How many
limitnumber - 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 with
search_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 list
company_list_idtextRequired - The company list. Pick one, or give its id from an earlier step.
- New name
nametext - A new name. Leave empty to keep it.
- New description
descriptiontext - 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"
}
}