RocketReach
App · 9 actions
Find people's work emails and phone numbers with RocketReach: search people and companies, look up contact and company details one at a time or in bulk, verify emails, and watch your credits.
Actions
| Action | What it does |
|---|---|
| Bulk look up people | Start lookups for up to 100 people at once (at least 10 on Universal Credits). |
| Check lookup status | See whether lookups have finished and get what they found, by the request ID a lookup or bulk lookup gave, or by profile IDs. |
| Get account | Get your RocketReach account: its plan, how many credits of each kind are left, and its rate limits. |
| Look up company | Get a company's details (size, revenue, industry, address, phone, technologies) by domain, name, LinkedIn URL or ticker. |
| Look up person | Find a person's email addresses and phone numbers from their LinkedIn URL, name and employer, email or RocketReach ID. |
| Look up person and company | Find a person's contact details and their company's details (size, revenue, industry, address) in one step. |
| Search companies | Find companies by name, domain, industry, location, size, revenue or technology. |
| Search people | Find people by job title, level, department, company, industry, location and more. |
| Verify email | Check whether an email address can receive mail: valid, invalid, catch-all or unknown. |
Bulk look up people
Start lookups for up to 100 people at once (at least 10 on Universal Credits). RocketReach sends the results to a webhook set up on its API settings page, which it requires; get them here with 'Check lookup status' and the request ID this returns.
Inputs
- People
peoplelistRequired - One entry per person, each with linkedin_url, or name and current_employer, or email, or id, for example [{"name": "Jamie Gullbrand", "current_employer": "RocketReach"}].
- What to find
what_to_findlist - What RocketReach should find, which decides the credits used. Leave empty for your plan's usual lookup (on Universal Credits, the work email).One or more of:
professional_email(Work email),personal_email(Personal email),phone(Phone number),details(Profile details (job history, education, skills)). - Webhook ID
webhook_idnumber - Which of your RocketReach webhooks gets the results. Leave empty for the first one turned on.
- Add to list
profile_listtext - The name of a RocketReach list to add the people to.
Outputs
people_countnumber- How many were sent
request_idtext- The bulk lookup's request ID, for 'Check lookup status'
responseobject- What RocketReach answered
Example output
{
"people_count": 2,
"request_id": "85c36d54-8c43-4a97-8a7d-782d8a0f938f",
"response": {}
}Check lookup status
See whether lookups have finished and get what they found, by the request ID a lookup or bulk lookup gave, or by profile IDs. Uses no credits.
Inputs
- Request ID
request_idtext - The 'request_id' from 'Look up person' or 'Bulk look up people'. Used instead of profile IDs when given.
- Profile IDs
profile_idslist - RocketReach profile IDs, up to 100.
Outputs
completetrue/false- Whether every lookup has finished
countnumber- How many
pending_countnumber- How many are still being looked up
profileslist- The looked-up people
Example output
{
"complete": true,
"count": 1,
"pending_count": 0,
"profiles": [
{
"city": "San Francisco",
"country_code": "US",
"current_employer": "RocketReach",
"current_employer_domain": "rocketreach.co",
"current_employer_id": 4421,
"current_employer_industry": "Software Development",
"current_employer_linkedin_url": "https://www.linkedin.com/company/rocketreach.co",
"current_employer_website": "https://rocketreach.co",
"current_personal_email": null,
"current_title": "Product Manager",
"current_work_email": "jamie@rocketreach.co",
"education": [
{
"degree": "Bachelors",
"major": "Economics",
"school": "Stanford University"
}
],
"emails": [
{
"email": "jamie@rocketreach.co",
"grade": "A",
"last_validation_check": "2026-11-01T12:00:00Z",
"smtp_valid": "valid",
"type": "professional"
}
],
"id": 5244,
"job_history": [
{
"company_id": 4421,
"company_name": "RocketReach",
"department": "Product Management",
"end_date": "Present",
"is_current": true,
"start_date": "2022-01-01",
"title": "Product Manager"
}
],
"linkedin_url": "https://www.linkedin.com/in/jamesgullbrand",
"links": {
"linkedin": "https://www.linkedin.com/in/jamesgullbrand"
},
"location": "San Francisco, CA, US",
"name": "Jamie Gullbrand",
"phones": [
{
"country_code": "1",
"e164": "+12345556789",
"extension": null,
"grade": "A",
"number": "+1 234-555-6789",
"recommended": true,
"type": "mobile"
}
],
"recommended_email": "jamie@rocketreach.co",
"recommended_personal_email": null,
"recommended_professional_email": "jamie@rocketreach.co",
"region": "California",
"skills": [
"Product Management"
],
"status": "complete"
}
]
}Get account
Get your RocketReach account: its plan, how many credits of each kind are left, and its rate limits. Uses no credits.
Inputs
None.
Outputs
accountobject- The account as RocketReach gives it
credit_systemtext- standard or universal, as connected
creditslist- Each kind of credit on the plan, with what is left
Example output
{
"account": {
"credit_usage": [
{
"allocated": 1000,
"credit_type": "premium_lookup",
"remaining": 880,
"used": 120
}
],
"email": "jo@example.com",
"first_name": "Jo",
"id": 123456,
"last_name": "Bloggs",
"plan": {
"id": 7,
"name": "Pro"
},
"rate_limits": [
{
"action": "person_lookup",
"duration": "day",
"limit": 1500,
"remaining": 1488,
"used": 12
}
],
"state": "registered"
},
"credit_system": "standard",
"credits": [
{
"allocated": 1000,
"credit_type": "premium_lookup",
"remaining": 880,
"used": 120
}
]
}Look up company
Get a company's details (size, revenue, industry, address, phone, technologies) by domain, name, LinkedIn URL or ticker. Uses a company credit.
Inputs
- Domain
domaintext - The company's website domain, such as acme.com (the surest way).
- Name
nametext - The company's name.
- LinkedIn URL
linkedin_urltext - The company's LinkedIn page address.
- Stock ticker
tickertext - Its stock ticker, such as AAPL.
- RocketReach company ID
company_idnumber - Its RocketReach ID, from 'Search companies'.
Outputs
companyobject- The company
company_idnumber- Its RocketReach ID
Example output
{
"company": {
"address": {
"city": "Seattle",
"country": "United States",
"country_code": "US",
"postal_code": "98101",
"region": "Washington",
"street": "1 Example St"
},
"competitors": [
"example.com"
],
"description": "Contact and company data.",
"domain": "rocketreach.co",
"email_domain": "rocketreach.co",
"id": 4421,
"industries": [
"Software Development"
],
"industry": "Software Development",
"links": {
"linkedin": "https://www.linkedin.com/company/rocketreach.co"
},
"name": "RocketReach",
"num_employees": 120,
"phone": "+1 206-555-0100",
"revenue": 25000000,
"rr_profile_url": "https://rocketreach.co/rocketreach-profile_b5c8",
"techstack": [
"Salesforce"
],
"ticker_symbol": null,
"website_domain": "rocketreach.co",
"year_founded": 2015
},
"company_id": 4421
}Look up person
Find a person's email addresses and phone numbers from their LinkedIn URL, name and employer, email or RocketReach ID. Uses credits when something is found. Waits up to half a minute for RocketReach to finish.
Inputs
- LinkedIn URL
linkedin_urltext - The person's LinkedIn profile address, the surest way to find them.
- Name
nametext - The person's full name. Give their current employer too.
- Current employer
current_employertext - The company they work for now, given with their name.
- Job title
titletext - Their job title, to help tell apart people with one name.
- Email address
emailtext - An email address of theirs you already have.
- Phone number
phonetext - A phone number of theirs, with the country code (+15555555555).
- RocketReach profile ID
profile_idnumber - The person's RocketReach ID, from 'Search people'.
- What to find
what_to_findlist - What RocketReach should find, which decides the credits used. Leave empty for your plan's usual lookup (on Universal Credits, the work email).One or more of:
professional_email(Work email),personal_email(Personal email),phone(Phone number),details(Profile details (job history, education, skills)).
Outputs
completetrue/false- Whether RocketReach finished; if not, use 'Check lookup status'
profileobject- The person, with what was found
profile_idnumber- The person's RocketReach ID
request_idtext- The lookup's request ID, for 'Check lookup status'
statustext- complete, or progress/searching/waiting while still finding
Example output
{
"complete": true,
"profile": {
"city": "San Francisco",
"country_code": "US",
"current_employer": "RocketReach",
"current_employer_domain": "rocketreach.co",
"current_employer_id": 4421,
"current_employer_industry": "Software Development",
"current_employer_linkedin_url": "https://www.linkedin.com/company/rocketreach.co",
"current_employer_website": "https://rocketreach.co",
"current_personal_email": null,
"current_title": "Product Manager",
"current_work_email": "jamie@rocketreach.co",
"education": [
{
"degree": "Bachelors",
"major": "Economics",
"school": "Stanford University"
}
],
"emails": [
{
"email": "jamie@rocketreach.co",
"grade": "A",
"last_validation_check": "2026-11-01T12:00:00Z",
"smtp_valid": "valid",
"type": "professional"
}
],
"id": 5244,
"job_history": [
{
"company_id": 4421,
"company_name": "RocketReach",
"department": "Product Management",
"end_date": "Present",
"is_current": true,
"start_date": "2022-01-01",
"title": "Product Manager"
}
],
"linkedin_url": "https://www.linkedin.com/in/jamesgullbrand",
"links": {
"linkedin": "https://www.linkedin.com/in/jamesgullbrand"
},
"location": "San Francisco, CA, US",
"name": "Jamie Gullbrand",
"phones": [
{
"country_code": "1",
"e164": "+12345556789",
"extension": null,
"grade": "A",
"number": "+1 234-555-6789",
"recommended": true,
"type": "mobile"
}
],
"recommended_email": "jamie@rocketreach.co",
"recommended_personal_email": null,
"recommended_professional_email": "jamie@rocketreach.co",
"region": "California",
"skills": [
"Product Management"
],
"status": "complete"
},
"profile_id": 5244,
"request_id": "85c36d54-8c43-4a97-8a7d-782d8a0f938f",
"status": "complete"
}Look up person and company
Find a person's contact details and their company's details (size, revenue, industry, address) in one step. Uses a lookup and a company credit. Not available on Universal Credits.
Inputs
- LinkedIn URL
linkedin_urltext - The person's LinkedIn profile address, the surest way to find them.
- Name
nametext - The person's full name. Give their current employer too.
- Current employer
current_employertext - The company they work for now, given with their name.
- Job title
titletext - Their job title, to help tell apart people with one name.
- Email address
emailtext - An email address of theirs you already have.
- Phone number
phonetext - A phone number of theirs, with the country code (+15555555555).
- RocketReach profile ID
profile_idnumber - The person's RocketReach ID, from 'Search people'.
- What to find
what_to_findlist - What RocketReach should find, which decides the credits used. Leave empty for your plan's usual lookup (on Universal Credits, the work email).One or more of:
professional_email(Work email),personal_email(Personal email),phone(Phone number),details(Profile details (job history, education, skills)).
Outputs
companyobject- Their current company
completetrue/false- Whether RocketReach finished; if not, use 'Check lookup status'
profileobject- The person, with what was found
profile_idnumber- The person's RocketReach ID
request_idtext- The lookup's request ID, for 'Check lookup status'
statustext- complete, or progress/searching/waiting while still finding
Example output
{
"company": {
"address": {
"city": "Seattle",
"country": "United States",
"country_code": "US",
"postal_code": "98101",
"region": "Washington",
"street": "1 Example St"
},
"competitors": [
"example.com"
],
"description": "Contact and company data.",
"domain": "rocketreach.co",
"email_domain": "rocketreach.co",
"id": 4421,
"industries": [
"Software Development"
],
"industry": "Software Development",
"links": {
"linkedin": "https://www.linkedin.com/company/rocketreach.co"
},
"name": "RocketReach",
"num_employees": 120,
"phone": "+1 206-555-0100",
"revenue": 25000000,
"rr_profile_url": "https://rocketreach.co/rocketreach-profile_b5c8",
"techstack": [
"Salesforce"
],
"ticker_symbol": null,
"website_domain": "rocketreach.co",
"year_founded": 2015
},
"complete": true,
"profile": {
"city": "San Francisco",
"country_code": "US",
"current_employer": "RocketReach",
"current_employer_domain": "rocketreach.co",
"current_employer_id": 4421,
"current_employer_industry": "Software Development",
"current_employer_linkedin_url": "https://www.linkedin.com/company/rocketreach.co",
"current_employer_website": "https://rocketreach.co",
"current_personal_email": null,
"current_title": "Product Manager",
"current_work_email": "jamie@rocketreach.co",
"education": [
{
"degree": "Bachelors",
"major": "Economics",
"school": "Stanford University"
}
],
"emails": [
{
"email": "jamie@rocketreach.co",
"grade": "A",
"last_validation_check": "2026-11-01T12:00:00Z",
"smtp_valid": "valid",
"type": "professional"
}
],
"id": 5244,
"job_history": [
{
"company_id": 4421,
"company_name": "RocketReach",
"department": "Product Management",
"end_date": "Present",
"is_current": true,
"start_date": "2022-01-01",
"title": "Product Manager"
}
],
"linkedin_url": "https://www.linkedin.com/in/jamesgullbrand",
"links": {
"linkedin": "https://www.linkedin.com/in/jamesgullbrand"
},
"location": "San Francisco, CA, US",
"name": "Jamie Gullbrand",
"phones": [
{
"country_code": "1",
"e164": "+12345556789",
"extension": null,
"grade": "A",
"number": "+1 234-555-6789",
"recommended": true,
"type": "mobile"
}
],
"recommended_email": "jamie@rocketreach.co",
"recommended_personal_email": null,
"recommended_professional_email": "jamie@rocketreach.co",
"region": "California",
"skills": [
"Product Management"
],
"status": "complete"
},
"profile_id": 5244,
"request_id": "85c36d54-8c43-4a97-8a7d-782d8a0f938f",
"status": "complete"
}Search companies
Find companies by name, domain, industry, location, size, revenue or technology. Get full details with 'Look up company'.
Inputs
- Names
namelist - Company names.
- Domains
domainlist - Website domains, such as acme.com.
- Keywords
keywordlist - Words to match in what the company does.
- Industries
industrylist - Industries, such as Software Development.
- Locations
locationlist - Where they are, such as Boston, MA, US.
- Employee counts
employeeslist - Sizes, such as 51-200 or 1000+.
- Revenue
revenuelist - Yearly revenue in dollars, such as 10000000-50000000 or 1000000+.
- Technologies
techstacklist - Technologies they use, such as Salesforce.
- Order
order_bytext - How to sort the results. Defaults to best match.One of:
relevance(Best match (default)),popularity(Decision makers first),score. - Results per page
page_sizenumber - How many to get per page, 1 to 100. Defaults to 10.From 1 to 100.
- Pages
pagesnumber - How many pages to read, 1 to 10. Defaults to 1. Each page counts towards your search allowance.From 1 to 10.
- Start at result
startnumber - The result to start from, counting from 1, such as the 'next_start' an earlier search gave.From 1 to 10000.
Outputs
companieslist- The companies found
countnumber- How many were returned
next_startnumber- The 'Start at result' for the next page, 0 if there is none
paginationobject- RocketReach's paging details for the last page read
Example output
{
"companies": [
{
"city": "Seattle",
"country_code": "US",
"email_domain": "rocketreach.co",
"id": 4421,
"industry_str": "Software Development",
"name": "RocketReach",
"region": "Washington",
"ticker_symbol": null
}
],
"count": 1,
"next_start": 0,
"pagination": {
"next": 11,
"start": 1,
"total": 1
}
}Search people
Find people by job title, level, department, company, industry, location and more. Gives names, titles and employers but no contact details: look those up with 'Look up person'.
Inputs
- Job titles
current_titlelist - Current job titles, such as VP of Sales.
- Management levels
management_levelslist - Only people at these levels.One or more of:
Founder/Owner,C-Level,Vice President,Head,Director,Manager,Senior,Individual Contributor,Entry,Intern,Volunteer. - Departments
departmentlist - Only people in these departments.One or more of:
Executive(Executive (C-Suite)),Founder(Founder (C-Suite)),Product & Engineering Executive(Product & Engineering Executive (C-Suite)),Finance Executive(Finance Executive (C-Suite)),HR Executive(HR Executive (C-Suite)),Legal Executive(Legal Executive (C-Suite)),Marketing Executive(Marketing Executive (C-Suite)),Health Executive(Health Executive (C-Suite)),Operations Executive(Operations Executive (C-Suite)),Sales Executive(Sales Executive (C-Suite)), and 82 more. - Current employers
employerlist - Companies they work for now.
- Company domains
company_domainlist - Their company's website domain, such as acme.com.
- Locations
locationlist - Where they are: a city, region or country, such as San Francisco, CA, US.
- Company industries
company_industrylist - Only people whose company is in these industries.One or more of:
Agriculture(Agriculture (Agriculture & Fishing)),Crops(Crops (Agriculture & Fishing)),Dairy(Dairy (Agriculture & Fishing)),Farming Animals & Livestock(Farming Animals & Livestock (Agriculture & Fishing)),Fishery & Aquaculture(Fishery & Aquaculture (Agriculture & Fishing)),Ranching(Ranching (Agriculture & Fishing)),Accounting & Accounting Services(Accounting & Accounting Services (Business Services)),Auctions(Auctions (Business Services)),Business Services - General(Business Services - General (Business Services)),Call Centers & Business Centers(Call Centers & Business Centers (Business Services)), and 293 more. - Company sizes
company_sizelist - Employee counts, such as 51-200 or 1000+.
- Names
namelist - People's names.
- Keywords
keywordtext - Words to match anywhere in their profile.
- Has contact details
contact_methodlist - Only people RocketReach has any of these for.One or more of:
work email,personal email,mobile(Mobile phone),direct dial,office phone. - Email quality
email_gradetext - Only people whose best email is at least this grade.One of:
A(A (best)),A-(A- or better),B(B or better). - Recent job change
job_changetext - Only people who recently moved company or were promoted.One of:
Company Change::one_week(Changed company in the last week),Company Change::one_month(Changed company in the last month),Company Change::three_months(Changed company in the last 3 months),Promotion::one_week(Promoted in the last week),Promotion::one_month(Promoted in the last month),Promotion::three_months(Promoted in the last 3 months). - Previous employers
previous_employerlist - Companies they worked for before.
- Skills
skillslist - Any of these skills, such as Python.
- Schools
schoollist - Schools or universities they attended.
- Order
order_bytext - How to sort the results. Defaults to best match.One of:
relevance(Best match (default)),popularity(Decision makers first),score. - Results per page
page_sizenumber - How many to get per page, 1 to 100. Defaults to 10.From 1 to 100.
- Pages
pagesnumber - How many pages to read, 1 to 10. Defaults to 1. Each page counts towards your search allowance.From 1 to 10.
- Start at result
startnumber - The result to start from, counting from 1, such as the 'next_start' an earlier search gave.From 1 to 10000.
Outputs
countnumber- How many were returned
next_startnumber- The 'Start at result' for the next page, 0 if there is none
paginationobject- RocketReach's paging details for the last page read
profileslist- The people found
Example output
{
"count": 1,
"next_start": 0,
"pagination": {
"next": 11,
"start": 1,
"total": 1
},
"profiles": [
{
"city": "San Francisco",
"country_code": "US",
"current_employer": "RocketReach",
"current_employer_domain": "rocketreach.co",
"current_employer_id": 4421,
"current_employer_website": "https://rocketreach.co",
"current_title": "Product Manager",
"id": 5244,
"linkedin_url": "https://www.linkedin.com/in/jamesgullbrand",
"location": "San Francisco, CA, US",
"name": "Jamie Gullbrand",
"region": "California",
"status": "complete",
"teaser": {
"professional_emails": [
"rocketreach.co"
]
},
"update_time": "2026-10-01T00:00:00Z"
}
]
}Verify email
Check whether an email address can receive mail: valid, invalid, catch-all or unknown. Uses one email verification credit, refunded when the answer is unknown.
Inputs
- Email address
emailtextRequired - The address to check.
Outputs
checksobject- What was checked
credits_chargednumber- Verification credits used: 1, or 0 if refunded
emailtext- The address checked, tidied
mx_recordtext- The domain's main mail server, if any
statustext- valid, invalid, catchall or unknown
Example output
{
"checks": {
"catchall": false,
"disposable": false,
"domain_valid": true,
"format_valid": true
},
"credits_charged": 1,
"email": "jamie@rocketreach.co",
"mx_record": "aspmx.l.google.com",
"status": "valid"
}