# RocketReach

> 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.

App · 9 actions. Web page: https://docs.lodol.com/docs/integrations/rocketreach

## Actions

### 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 (`people`, list, required): 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_find`, list): 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_id`, number): Which of your RocketReach webhooks gets the results. Leave empty for the first one turned on.
- Add to list (`profile_list`, text): The name of a RocketReach list to add the people to.

**Outputs**

- `people_count` (number): How many were sent
- `request_id` (text): The bulk lookup's request ID, for 'Check lookup status'
- `response` (object): What RocketReach answered

**Example output**

```json
{
  "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_id`, text): The 'request_id' from 'Look up person' or 'Bulk look up people'. Used instead of profile IDs when given.
- Profile IDs (`profile_ids`, list): RocketReach profile IDs, up to 100.

**Outputs**

- `complete` (true/false): Whether every lookup has finished
- `count` (number): How many
- `pending_count` (number): How many are still being looked up
- `profiles` (list): The looked-up people

**Example output**

```json
{
  "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**

- `account` (object): The account as RocketReach gives it
- `credit_system` (text): standard or universal, as connected
- `credits` (list): Each kind of credit on the plan, with what is left

**Example output**

```json
{
  "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 (`domain`, text): The company's website domain, such as acme.com (the surest way).
- Name (`name`, text): The company's name.
- LinkedIn URL (`linkedin_url`, text): The company's LinkedIn page address.
- Stock ticker (`ticker`, text): Its stock ticker, such as AAPL.
- RocketReach company ID (`company_id`, number): Its RocketReach ID, from 'Search companies'.

**Outputs**

- `company` (object): The company
- `company_id` (number): Its RocketReach ID

**Example output**

```json
{
  "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_url`, text): The person's LinkedIn profile address, the surest way to find them.
- Name (`name`, text): The person's full name. Give their current employer too.
- Current employer (`current_employer`, text): The company they work for now, given with their name.
- Job title (`title`, text): Their job title, to help tell apart people with one name.
- Email address (`email`, text): An email address of theirs you already have.
- Phone number (`phone`, text): A phone number of theirs, with the country code (+15555555555).
- RocketReach profile ID (`profile_id`, number): The person's RocketReach ID, from 'Search people'.
- What to find (`what_to_find`, list): 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**

- `complete` (true/false): Whether RocketReach finished; if not, use 'Check lookup status'
- `profile` (object): The person, with what was found
- `profile_id` (number): The person's RocketReach ID
- `request_id` (text): The lookup's request ID, for 'Check lookup status'
- `status` (text): complete, or progress/searching/waiting while still finding

**Example output**

```json
{
  "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_url`, text): The person's LinkedIn profile address, the surest way to find them.
- Name (`name`, text): The person's full name. Give their current employer too.
- Current employer (`current_employer`, text): The company they work for now, given with their name.
- Job title (`title`, text): Their job title, to help tell apart people with one name.
- Email address (`email`, text): An email address of theirs you already have.
- Phone number (`phone`, text): A phone number of theirs, with the country code (+15555555555).
- RocketReach profile ID (`profile_id`, number): The person's RocketReach ID, from 'Search people'.
- What to find (`what_to_find`, list): 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**

- `company` (object): Their current company
- `complete` (true/false): Whether RocketReach finished; if not, use 'Check lookup status'
- `profile` (object): The person, with what was found
- `profile_id` (number): The person's RocketReach ID
- `request_id` (text): The lookup's request ID, for 'Check lookup status'
- `status` (text): complete, or progress/searching/waiting while still finding

**Example output**

```json
{
  "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 (`name`, list): Company names.
- Domains (`domain`, list): Website domains, such as acme.com.
- Keywords (`keyword`, list): Words to match in what the company does.
- Industries (`industry`, list): Industries, such as Software Development.
- Locations (`location`, list): Where they are, such as Boston, MA, US.
- Employee counts (`employees`, list): Sizes, such as 51-200 or 1000+.
- Revenue (`revenue`, list): Yearly revenue in dollars, such as 10000000-50000000 or 1000000+.
- Technologies (`techstack`, list): Technologies they use, such as Salesforce.
- Order (`order_by`, text): How to sort the results. Defaults to best match. One of: `relevance` (Best match (default)), `popularity` (Decision makers first), `score`.
- Results per page (`page_size`, number): How many to get per page, 1 to 100. Defaults to 10. From 1 to 100.
- Pages (`pages`, number): 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 (`start`, number): The result to start from, counting from 1, such as the 'next_start' an earlier search gave. From 1 to 10000.

**Outputs**

- `companies` (list): The companies found
- `count` (number): How many were returned
- `next_start` (number): The 'Start at result' for the next page, 0 if there is none
- `pagination` (object): RocketReach's paging details for the last page read

**Example output**

```json
{
  "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_title`, list): Current job titles, such as VP of Sales.
- Management levels (`management_levels`, list): 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 (`department`, list): 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 (`employer`, list): Companies they work for now.
- Company domains (`company_domain`, list): Their company's website domain, such as acme.com.
- Locations (`location`, list): Where they are: a city, region or country, such as San Francisco, CA, US.
- Company industries (`company_industry`, list): 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_size`, list): Employee counts, such as 51-200 or 1000+.
- Names (`name`, list): People's names.
- Keywords (`keyword`, text): Words to match anywhere in their profile.
- Has contact details (`contact_method`, list): 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_grade`, text): 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_change`, text): 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_employer`, list): Companies they worked for before.
- Skills (`skills`, list): Any of these skills, such as Python.
- Schools (`school`, list): Schools or universities they attended.
- Order (`order_by`, text): How to sort the results. Defaults to best match. One of: `relevance` (Best match (default)), `popularity` (Decision makers first), `score`.
- Results per page (`page_size`, number): How many to get per page, 1 to 100. Defaults to 10. From 1 to 100.
- Pages (`pages`, number): 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 (`start`, number): The result to start from, counting from 1, such as the 'next_start' an earlier search gave. From 1 to 10000.

**Outputs**

- `count` (number): How many were returned
- `next_start` (number): The 'Start at result' for the next page, 0 if there is none
- `pagination` (object): RocketReach's paging details for the last page read
- `profiles` (list): The people found

**Example output**

```json
{
  "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 (`email`, text, required): The address to check.

**Outputs**

- `checks` (object): What was checked
- `credits_charged` (number): Verification credits used: 1, or 0 if refunded
- `email` (text): The address checked, tidied
- `mx_record` (text): The domain's main mail server, if any
- `status` (text): valid, invalid, catchall or unknown

**Example output**

```json
{
  "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"
}
```
