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

ActionWhat it does
Bulk look up peopleStart lookups for up to 100 people at once (at least 10 on Universal Credits).
Check lookup statusSee whether lookups have finished and get what they found, by the request ID a lookup or bulk lookup gave, or by profile IDs.
Get accountGet your RocketReach account: its plan, how many credits of each kind are left, and its rate limits.
Look up companyGet a company's details (size, revenue, industry, address, phone, technologies) by domain, name, LinkedIn URL or ticker.
Look up personFind a person's email addresses and phone numbers from their LinkedIn URL, name and employer, email or RocketReach ID.
Look up person and companyFind a person's contact details and their company's details (size, revenue, industry, address) in one step.
Search companiesFind companies by name, domain, industry, location, size, revenue or technology.
Search peopleFind people by job title, level, department, company, industry, location and more.
Verify emailCheck 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

PeoplepeoplelistRequired
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 findwhat_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 IDwebhook_idnumber
Which of your RocketReach webhooks gets the results. Leave empty for the first one turned on.
Add to listprofile_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 IDrequest_idtext
The 'request_id' from 'Look up person' or 'Bulk look up people'. Used instead of profile IDs when given.
Profile IDsprofile_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

Domaindomaintext
The company's website domain, such as acme.com (the surest way).
Namenametext
The company's name.
LinkedIn URLlinkedin_urltext
The company's LinkedIn page address.
Stock tickertickertext
Its stock ticker, such as AAPL.
RocketReach company IDcompany_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 URLlinkedin_urltext
The person's LinkedIn profile address, the surest way to find them.
Namenametext
The person's full name. Give their current employer too.
Current employercurrent_employertext
The company they work for now, given with their name.
Job titletitletext
Their job title, to help tell apart people with one name.
Email addressemailtext
An email address of theirs you already have.
Phone numberphonetext
A phone number of theirs, with the country code (+15555555555).
RocketReach profile IDprofile_idnumber
The person's RocketReach ID, from 'Search people'.
What to findwhat_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 URLlinkedin_urltext
The person's LinkedIn profile address, the surest way to find them.
Namenametext
The person's full name. Give their current employer too.
Current employercurrent_employertext
The company they work for now, given with their name.
Job titletitletext
Their job title, to help tell apart people with one name.
Email addressemailtext
An email address of theirs you already have.
Phone numberphonetext
A phone number of theirs, with the country code (+15555555555).
RocketReach profile IDprofile_idnumber
The person's RocketReach ID, from 'Search people'.
What to findwhat_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

Namesnamelist
Company names.
Domainsdomainlist
Website domains, such as acme.com.
Keywordskeywordlist
Words to match in what the company does.
Industriesindustrylist
Industries, such as Software Development.
Locationslocationlist
Where they are, such as Boston, MA, US.
Employee countsemployeeslist
Sizes, such as 51-200 or 1000+.
Revenuerevenuelist
Yearly revenue in dollars, such as 10000000-50000000 or 1000000+.
Technologiestechstacklist
Technologies they use, such as Salesforce.
Orderorder_bytext
How to sort the results. Defaults to best match.One of: relevance (Best match (default)), popularity (Decision makers first), score.
Results per pagepage_sizenumber
How many to get per page, 1 to 100. Defaults to 10.From 1 to 100.
Pagespagesnumber
How many pages to read, 1 to 10. Defaults to 1. Each page counts towards your search allowance.From 1 to 10.
Start at resultstartnumber
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 titlescurrent_titlelist
Current job titles, such as VP of Sales.
Management levelsmanagement_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.
Departmentsdepartmentlist
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 employersemployerlist
Companies they work for now.
Company domainscompany_domainlist
Their company's website domain, such as acme.com.
Locationslocationlist
Where they are: a city, region or country, such as San Francisco, CA, US.
Company industriescompany_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 sizescompany_sizelist
Employee counts, such as 51-200 or 1000+.
Namesnamelist
People's names.
Keywordskeywordtext
Words to match anywhere in their profile.
Has contact detailscontact_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 qualityemail_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 changejob_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 employersprevious_employerlist
Companies they worked for before.
Skillsskillslist
Any of these skills, such as Python.
Schoolsschoollist
Schools or universities they attended.
Orderorder_bytext
How to sort the results. Defaults to best match.One of: relevance (Best match (default)), popularity (Decision makers first), score.
Results per pagepage_sizenumber
How many to get per page, 1 to 100. Defaults to 10.From 1 to 100.
Pagespagesnumber
How many pages to read, 1 to 10. Defaults to 1. Each page counts towards your search allowance.From 1 to 10.
Start at resultstartnumber
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 addressemailtextRequired
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"
}

On this page