RocketReach API

https://docs.rocketreach.co/
Admin
The RocketReach API provides RESTful access to contact information for over 700M professionals and...
Tokens:42,546
Snippets:306
Trust Score:9.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### Initial Lookup Response Example

Source: https://docs.rocketreach.co/reference/check_universal_person_lookup_status

Example response received after initiating a lookup for a specific profile.

```response
 [
    {
        "id": 5244,
        "status": "searching",
        "name": "Mark Benioff",
        "current_employer": "Salesforce",
        "current_title": "CEO"
    }
 ]
```

--------------------------------

### Profile Status Example

Source: https://docs.rocketreach.co/reference/people-lookup-api

Example value for the status field in a profile lookup response.

```json
"example": "progress"
```

--------------------------------

### GET /person/lookup

Source: https://docs.rocketreach.co/reference/rocketreach-api

An example endpoint for looking up person contact information.

```APIDOC
## GET /person/lookup

### Description
Retrieves contact information for a specific professional.

### Method
GET

### Endpoint
/person/lookup
```

--------------------------------

### GET /account/

Source: https://docs.rocketreach.co/reference/rocketreach-api-account

Retrieve the current account details and usage information.

```APIDOC
## GET /account/

### Description
Retrieve & Manage Account Details. This endpoint returns the account object containing information about your RocketReach account.

### Method
GET

### Endpoint
/account/

### Response
#### Success Response (200)
- **UserModel** (object) - Returns the account object.

#### Error Responses
- **400** - Bad Request. The request is malformed or missing required parameters.
- **401** - Unauthorized. API Key is missing or invalid.
- **403** - Forbidden. API Key lacks permission to perform this action.
- **404** - Not Found. The requested resource does not exist.
- **429** - Too Many Requests. API request limit reached.
- **500** - Internal Server Error. Unexpected error on RocketReach servers.
```

--------------------------------

### Company Industry Keywords Example

Source: https://docs.rocketreach.co/reference/people-search-api

Example usage for filtering by industry keywords.

```json
['SaaS', 'B2B']
```

--------------------------------

### Completed Lookup Response

Source: https://docs.rocketreach.co/reference/check_universal_person_lookup_status

Example response returned once the lookup status reaches complete.

```response
[
    {
        "id": 5244,
        "status": "complete",
        "profile_pic": "https://images.com/profile_images/....jpeg",
        "name": "Mark Benioff",
        "links": [
        "..."
        ]
    }
]
```

--------------------------------

### Example Tool Usage Queries

Source: https://docs.rocketreach.co/reference/mcp-claude-code-setup

Natural language prompts for triggering RocketReach tools within a Claude session.

```text
Find senior engineers at fintech companies in London with 500+ employees
```

```text
Search for B2B SaaS companies using Salesforce with over $10M in funding
```

```text
How many API credits do I have left?
```

--------------------------------

### GET /mcp-oauth/authorize

Source: https://docs.rocketreach.co/reference/mcp-auth

Redirects the user to the authorization server for consent using PKCE.

```APIDOC
## GET /mcp-oauth/authorize

### Description
Redirects the user's browser to the authorization server with a PKCE code_challenge to initiate the user consent flow.

### Method
GET

### Endpoint
https://rocketreach.co/mcp-oauth/authorize
```

--------------------------------

### Polling Status Response

Source: https://docs.rocketreach.co/reference/check_universal_person_lookup_status

Example response returned while a lookup is still in progress.

```response
 [
    {
        "id": 5244,
        "status": "searching"
    }
 ]
```

--------------------------------

### person_lookup complete response

Source: https://docs.rocketreach.co/reference/mcp-tools

Example of a successful lookup response containing contact details and profile metadata.

```json
{
  "profile_id": 101,
  "status": "complete",
  "name": "Ada Lovelace",
  "current_title": "Engineer",
  "current_employer": "Acme",
  "emails": [{ "email": "ada@acme.com", "grade": "A" }],
  "phones": [{ "number": "+1-555-0101", "type": "direct" }]
}
```

--------------------------------

### GET /universal/account/

Source: https://docs.rocketreach.co/reference/get_universal_account

Retrieves the account details and associated attributes for the authenticated user.

```APIDOC
## GET /universal/account/

### Description
Retrieve & Manage Account Details

### Method
GET

### Endpoint
/universal/account/

### Response
#### Success Response (200)
- **UniversalCreditsUserModelWithExtraAttributes** (object) - Returns the account object containing user details and credit information.

#### Error Responses
- **400** - Bad Request. The request is malformed or missing required parameters.
- **401** - Unauthorized. API Key is missing or invalid.
- **403** - Forbidden. API Key lacks permission to perform this action.
- **404** - Not Found. The requested resource does not exist.
- **429** - Too Many Requests. API request limit reached.
- **500** - Internal Server Error. Unexpected error on RocketReach servers.
```

--------------------------------

### GET /.well-known/oauth-protected-resource

Source: https://docs.rocketreach.co/reference/mcp-auth

Fetches the resource identifier and authorization server details for the MCP server.

```APIDOC
## GET /.well-known/oauth-protected-resource

### Description
Fetches the resource identifier and its associated authorization server(s) to initiate the discovery chain.

### Method
GET

### Endpoint
https://mcp.rocketreach.co/.well-known/oauth-protected-resource
```

--------------------------------

### GET /universal/person/lookup

Source: https://docs.rocketreach.co/reference/create_universal_person_lookup

Retrieves profile information for a person using various search parameters.

```APIDOC
## GET /universal/person/lookup

### Description
Person Enrichment API to look up professional profiles.

### Method
GET

### Endpoint
/universal/person/lookup

### Parameters
#### Query Parameters
- **current_employer** (string) - Optional - Current employer of the desired profile. Must specify along with `name`.
- **email** (string) - Optional - An email address for the desired profile.
- **id** (integer) - Optional - RocketReach internal unique profile ID.
- **linkedin_url** (string) - Optional - LinkedIn URL of the desired profile.
- **metadata** (object) - Optional - User metadata about the profile, such as external ids, tags, notes, etc.
- **name** (string) - Optional - Name of the desired profile. Must specify along with `current_employer`.
- **npi_number** (integer) - Optional - An NPI number for the desired profile (US healthcare professional).
- **phone** (string) - Optional - A phone number for the desired profile in either E.164 format or international format.
```

--------------------------------

### GET /profile-company/lookup

Source: https://docs.rocketreach.co/reference/create_person_and_company_lookup

Retrieves profile information for a person or company based on provided query parameters.

```APIDOC
## GET /profile-company/lookup

### Description
Person and Company Lookup

### Method
GET

### Endpoint
/profile-company/lookup

### Parameters
#### Query Parameters
- **current_employer** (string) - Optional - Current employer of the desired profile. Must specify along with `name`.
- **email** (string) - Optional - An email address for the desired profile.
- **id** (integer) - Optional - RocketReach internal unique profile ID.
- **linkedin_ext_url** (string) - Optional - linkedin_ext_url deprecated, please use `linkedin_url` instead.
- **linkedin_url** (string) - Optional - LinkedIn URL of the desired profile.
- **lookup_type** (string) - Optional - Lookup type for the request (standard, premium, premium (feeds disabled), bulk, phone, enrich).
- **metadata** (object) - Optional - Metadata for the request.
```

--------------------------------

### Poll Lookup Status via cURL

Source: https://docs.rocketreach.co/reference/check_universal_person_lookup_status

Example request to poll the status of a profile lookup.

```bash
curl --request 'POST' --location 'https://api.rocketreach.co/v2/api/search'
	--header 'Api-Key: <YOUR API KEY>'
	--header 'Content-Type: application/json'
	--data '{"query":{"name":["Marc Benioff"]}}'
```

--------------------------------

### GET /account

Source: https://docs.rocketreach.co/reference/mcp-tools

Retrieve the authenticated user's RocketReach account information, including plan details, credit balances, and API usage metrics.

```APIDOC
## GET /account

### Description
Retrieve the authenticated user's RocketReach account information: plan name, credit balances, rate-limit status, and daily API call usage. No credits are consumed by this call.

### Method
GET

### Endpoint
/account

### Response
#### Success Response (200)
- **id** (integer) - RocketReach user ID
- **first_name** (string) - Account holder first name
- **last_name** (string) - Account holder last name
- **email** (string) - Account email
- **state** (string) - Account state: registered, test_user, or anonymous
- **plan** (object) - Plan name and lookup/export limits
- **api_key** (string) - The account's RocketReach API key
- **api_key_domain** (string) - Domain the API key is bound to, if any
- **lookup_credit_balance** (number | "inf") - Rollup lookup-credit balance
- **person_export_credit_balance** (number | "inf") - Rollup person-export balance
- **company_export_credit_balance** (number | "inf") - Rollup company-export balance
- **lifetime_credits_spent** (integer) - Total credits spent over the account's lifetime
- **lifetime_api_num_calls** (integer) - Total API calls over the account's lifetime
- **daily_api_num_calls** (integer) - API calls made today
- **daily_api_limit** (integer) - Daily API call limit
- **credit_usage** (array) - Per-type breakdown of credits
- **rate_limits** (array) - Per-action rate limits
```

--------------------------------

### Profile Lookup Response Structure

Source: https://docs.rocketreach.co/reference/mcp-tools

Example JSON response from a profile lookup, where the id field is used for subsequent person_lookup calls.

```json
{
  "pagination": { "start": 1, "next": 11, "total": 4242 },
  "profiles": [
    { "id": 101, "name": "Ada Lovelace", "current_title": "Engineer", "current_employer": "Acme", "location": "London, UK" }
  ]
}
```

--------------------------------

### GET /person/lookup

Source: https://docs.rocketreach.co/reference/create_person_and_company_lookup

Performs a lookup for a person and their associated company data based on provided query parameters.

```APIDOC
## GET /person/lookup

### Description
Retrieves profile and company data for a specific individual. Requires authentication via RocketReachAPIKey.

### Method
GET

### Endpoint
/person/lookup

### Parameters
#### Query Parameters
- **name** (string) - Optional - Name of the desired profile. Must specify along with `current_employer`.
- **npi_number** (integer) - Optional - An NPI number for the desired profile (US healthcare professional).
- **phone** (string) - Optional - A phone number for the desired profile in either E.164 format or international format.
- **return_cached_emails** (boolean) - Optional - Controls whether cached emails are included in the initial response. Defaults to `true`.
- **title** (string) - Optional - Job title of the desired profile.
- **webhook_id** (integer) - Optional - Your webhook's unique ID number.

### Response
#### Success Response (200)
- **RR-Request-ID** (string) - Lookup unique identifier.
- **Body** (object) - Returns the profile data and company data for the person / company lookup.

#### Error Responses
- **400** - Bad Request. The request is malformed or missing required parameters.
- **401** - Unauthorized. API Key is missing or invalid.
- **403** - Forbidden. API Key lacks permission to perform this action.
- **404** - Not Found. The requested resource does not exist.
```

--------------------------------

### GET /company/lookup/

Source: https://docs.rocketreach.co/reference/company-lookup-api

Retrieves metadata information for a company based on provided search criteria such as domain, name, or LinkedIn URL.

```APIDOC
## GET /company/lookup/

### Description
Search for company metadata using criteria like domain, name, or LinkedIn URL.

### Method
GET

### Endpoint
/company/lookup/

### Parameters
#### Query Parameters
- **domain** (string) - Optional - Domain of the desired company to lookup (preferred).
- **id** (integer) - Optional - RocketReach internal unique company ID.
- **linkedin_url** (string) - Optional - LinkedIn URL of the desired company to lookup.
- **name** (string) - Optional - Name of the desired company to lookup.
- **ticker** (string) - Optional - Stock ticker of the desired company to lookup.

### Response
#### Success Response (200)
- **data** (object) - Returns the profile data for the company lookup.

#### Error Responses
- **400** - Bad Request. The request is malformed or missing required parameters.
- **401** - Unauthorized. API Key is missing or invalid.
```

--------------------------------

### Handle Rate Limits in Python

Source: https://docs.rocketreach.co/reference/responses-and-errors

Demonstrates checking for a 429 status code and using the Retry-After header to pause execution before retrying the request.

```python
import time
import requests

api_key = "YOUR_API_KEY"
url = "https://api.rocketreach.co/api/v2/person/lookup"
headers = {"Api-Key": api_key}
params = {"name": "John Doe"}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 429:
    retry_after = int(response.headers.get("Retry-After", 5))
    print(f"Rate limit exceeded. Retrying in {retry_after} seconds...")
    time.sleep(retry_after)
    response = requests.get(url, headers=headers, params=params)
```

--------------------------------

### Verify RocketReach Integration

Source: https://docs.rocketreach.co/reference/mcp-claude-code-setup

Tests the connection by querying account status through the Claude CLI.

```bash
claude "Check my RocketReach account status"
```

--------------------------------

### Verify server connectivity with ping

Source: https://docs.rocketreach.co/reference/mcp-tools

Use this tool to verify connectivity and authentication before executing other tool calls.

```json
{
  "name": "rr-mcp-server",
  "version": "1.0.0",
  "message": "pong"
}
```

--------------------------------

### POST /account/key/

Source: https://docs.rocketreach.co/reference/rocketreach-api-account-newaccount

Generates a new API key for the authenticated RocketReach account.

```APIDOC
## POST /account/key/

### Description
Create a new API key for your RocketReach account.

### Method
POST

### Endpoint
/account/key/

### Request Body
- **api_key** (string) - Required - The API key for your account.

### Response
#### Success Response (200)
- **api_key** (string) - The newly generated API key.
```

--------------------------------

### GET /person/lookup

Source: https://docs.rocketreach.co/reference/people-lookup-api

Retrieves profile data for a person based on provided search criteria.

```APIDOC
## GET /person/lookup

### Description
Retrieves profile data for a person based on provided search criteria. This endpoint requires an API key for authentication.

### Method
GET

### Endpoint
/person/lookup

### Parameters
#### Query Parameters
- **name** (string) - Optional - Name of the desired profile. Must specify along with `current_employer`.
- **npi_number** (integer) - Optional - An NPI number for the desired profile (US healthcare professional).
- **phone** (string) - Optional - A phone number for the desired profile in either E.164 format or international format.
- **return_cached_emails** (boolean) - Optional - Controls whether cached emails are included in the initial response. Defaults to `true`.
- **title** (string) - Optional - Job title of the desired profile.
- **webhook_id** (integer) - Optional - Your webhook's unique ID number.

### Response
#### Success Response (200)
- **RR-Request-ID** (string) - Lookup unique identifier, will also be sent in the header of webhook.

#### Error Responses
- **400** - Bad Request. The request is malformed or missing required parameters.
- **401** - Unauthorized. API Key is missing or invalid.
- **403** - Forbidden. API Key lacks permission to perform this action.
- **404** - Not Found.
```

--------------------------------

### MCP Tools Overview

Source: https://docs.rocketreach.co/reference/mcp

The RocketReach MCP server exposes several tools that can be invoked by MCP-compatible clients.

```APIDOC
## Available Tools

- **person_search**: Search professional profiles by name, title, employer, location, or skills.
- **company_search**: Search companies by name, domain, industry, size, funding, or tech stack.
- **person_lookup**: Retrieve contact info for a person by ID, email, LinkedIn URL, NPI, or name + employer.
- **profile_company_lookup**: Retrieve contact info for a person and full details for their current company.
- **company_lookup**: Retrieve full details for a company by domain, ID, name, ticker, or LinkedIn URL.
- **account**: Check plan, credit balances, and rate-limit status.
- **check_person_status**: Poll the status of an in-progress person lookup.
- **ping**: Liveness check.
```

--------------------------------

### GET /universal/person/check_status

Source: https://docs.rocketreach.co/reference/check_universal_person_lookup_status

Retrieves the status and profile data for a list of provided profile IDs.

```APIDOC
## GET /universal/person/check_status

### Description
Check the status and retrieve profile data for a list of universal person lookup IDs.

### Method
GET

### Endpoint
/universal/person/check_status

### Parameters
#### Query Parameters
- **ids** (array of integers) - Required - List of Profile IDs

### Response
#### Success Response (200)
- **Response** (array) - Returns the status and profile data of the requested profiles.
```

--------------------------------

### Webhook Integration

Source: https://docs.rocketreach.co/reference/webhooks

How to associate a webhook with lookup requests and verify incoming data.

```APIDOC
## Webhook Integration

### Description
To receive lookup results via webhook, include the `webhook_id` in your People Lookup or Bulk People Lookup requests. If no ID is provided, the system defaults to your top-most enabled webhook.

### Authentication
To verify that data originated from RocketReach, use the `X-RocketReach-Signature` header. Compute an HMAC-SHA256 hash of the raw response body using your webhook secret and compare it to the provided signature.

### Request Parameters
- **webhook_id** (integer) - Optional - The ID of the webhook to receive the lookup results.

### Response Headers
- **RR-Request-ID** (string) - Used to correlate requests with responses.
- **X-RocketReach-Signature** (string) - HMAC-SHA256 signature for payload verification.
```

--------------------------------

### GET /person/checkStatus

Source: https://docs.rocketreach.co/reference/rocketreach-check-person-lookup-status-people-lookup-api

Checks the status and retrieves profile data for a list of requested profile IDs.

```APIDOC
## GET /person/checkStatus

### Description
Check the status and retrieve profile data for the requested person lookup profiles.

### Method
GET

### Endpoint
/person/checkStatus

### Parameters
#### Query Parameters
- **ids** (array of integers) - Required - List of Profile IDs

### Response
#### Success Response (200)
- **Response** (array) - Returns the status and profile data of the requested profiles.
```

--------------------------------

### Execute a People Search

Source: https://docs.rocketreach.co/reference/people-search-api

Initializes a search object, applies filters for name and title, and executes the request.

```javascript

                let search = rr.people.search()
                search = search.include({name: "John Smith"})
                search = search.include({currentTitle: "CEO"})
                const results =  await search.execute()
            
```

--------------------------------

### POST /mcp-oauth/register

Source: https://docs.rocketreach.co/reference/mcp-auth

Registers a new client for the MCP OAuth flow.

```APIDOC
## POST /mcp-oauth/register

### Description
Registers a new client application for the RocketReach MCP OAuth flow following RFC 7591.

### Method
POST

### Endpoint
/mcp-oauth/register
```

--------------------------------

### Manual MCP Configuration

Source: https://docs.rocketreach.co/reference/mcp-claude-code-setup

Directly edit the ~/.claude.json file to configure the RocketReach MCP server.

```json
{
  "mcpServers": {
    "rocketreach": {
      "url": "https://mcp.rocketreach.co/mcp"
    }
  }
}
```

--------------------------------

### person_lookup pending response

Source: https://docs.rocketreach.co/reference/mcp-tools

Example of a pending lookup response, indicating that the request is still processing and should be polled later.

```json
{
  "status": "pending",
  "profile_id": 101,
  "retry_after_seconds": 3,
  "name": "Ada Lovelace",
  "current_title": "Engineer",
  "current_employer": "Acme"
}
```

--------------------------------

### Company Size Parameter

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Include profiles with employers with these sizes.

```json
['51-200']
```

--------------------------------

### Company Website URL Parameter

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Include profiles with employers with these website URLs.

```json
['rocketreach.co']
```

--------------------------------

### GET /person/lookup

Source: https://docs.rocketreach.co/reference/create_universal_person_lookup

Performs a lookup for a person's profile data based on provided parameters and enrichment settings.

```APIDOC
## GET /person/lookup

### Description
Performs a lookup for a person's profile data. Supports various enrichment flags to reveal specific contact information.

### Method
GET

### Endpoint
/person/lookup

### Parameters
#### Query Parameters
- **return_cached_emails** (boolean) - Optional - Controls whether cached emails are included in the initial response when lookup status is progress. Defaults to true.
- **reveal_detailed_person_enrichment** (boolean) - Optional - Whether to reveal the detailed person enrichment data for the desired profile.
- **reveal_healthcare_enrichment** (boolean) - Optional - Whether to reveal the healthcare enrichment data for the desired profile.
- **reveal_personal_email** (boolean) - Optional - Whether to reveal the personal email enrichment data for the desired profile.
- **reveal_phone** (boolean) - Optional - Whether to reveal the phone enrichment data for the desired profile.
- **reveal_professional_email** (boolean) - Optional - Whether to reveal the professional email enrichment data for the desired profile.
- **title** (string) - Optional - Job title of the desired profile.
- **webhook_id** (integer) - Optional - Your webhook's unique ID number.

### Response
#### Success Response (200)
- **RR-Request-ID** (string) - Lookup unique identifier, will also be sent in the header of webhook.
- **Body** (object) - Returns the profile data for the person lookup.
```

--------------------------------

### GET /person/lookup

Source: https://docs.rocketreach.co/reference/people-lookup-api

Retrieves professional profiles based on provided identifiers like name, employer, or LinkedIn URL.

```APIDOC
## GET /person/lookup

### Description
Retrieves matching professional profiles based on provided identifiers such as name, employer, or location.

### Method
GET

### Endpoint
/person/lookup

### Parameters
#### Query Parameters
- **current_employer** (string) - Optional - Current employer of the desired profile. Must specify along with `name`.
- **email** (string) - Optional - An email address for the desired profile.
- **id** (integer) - Optional - RocketReach internal unique profile ID.
- **linkedin_url** (string) - Optional - LinkedIn URL of the desired profile.
- **lookup_type** (string) - Optional - Lookup type for the request (standard, premium, premium (feeds disabled), bulk, phone, enrich).
```

--------------------------------

### GET /universal/company/lookup

Source: https://docs.rocketreach.co/reference/create_universal_company_lookup

Retrieves metadata information for a company by searching with provided criteria like domain, name, or LinkedIn URL.

```APIDOC
## GET /universal/company/lookup

### Description
Search for company records using specific criteria such as domain, name, or LinkedIn URL.

### Method
GET

### Endpoint
/universal/company/lookup

### Parameters
#### Query Parameters
- **domain** (string) - Optional - Domain of the desired company to lookup (preferred).
- **id** (integer) - Optional - RocketReach internal unique company ID.
- **linkedin_url** (string) - Optional - LinkedIn URL of the desired company to lookup.
- **name** (string) - Optional - Name of the desired company to lookup.
- **ticker** (string) - Optional - Stock ticker of the desired company to lookup.
```

--------------------------------

### Configure API Security Scheme

Source: https://docs.rocketreach.co/reference/create_universal_person_lookup

Authentication configuration using the Api-Key header for RocketReach API requests.

```json
"securitySchemes": {
      "RocketReachAPIKey": {
        "type": "apiKey",
        "name": "Api-Key",
        "in": "header",
        "description": "RocketReach account API key. You can locate your API Key from the \"My API Key\" section of the [API account page](https://rocketreach.co/account?section=nav_gen_api). Requests to the API are authenticated using the Api-Key request header. Older clients may use an `api_key` query parameter, but this behavior is deprecated."
      }
    }
```

--------------------------------

### Company Revenue Parameter

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Include profiles with employers with these revenue values.

```json
['10000000-50000000']
```

--------------------------------

### Company Name Parameter

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Include profiles employed by these company names.

```json
['RocketReach']
```

--------------------------------

### RocketReach API v2 OpenAPI Configuration

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Defines the production server URL and authentication requirements using the Api-Key request header.

```json
{
  "description": "RocketReach account API key. You can locate your API Key from the \"My API Key\" section of the [API account page](https://rocketreach.co/account?section=nav_gen_api). Requests to the API are authenticated using the Api-Key request header. Older clients may use an `api_key` query parameter, but this behavior is deprecated."
      }
    }
  },
  "servers": [
    {
      "url": "https://api.rocketreach.co/api/v2",
      "description": "v2 Production Server"
    }
  ]
}
```

--------------------------------

### OpenAPI Definition for Check Person Lookup Status

Source: https://docs.rocketreach.co/reference/rocketreach-check-person-lookup-status-people-lookup-api

The OpenAPI specification defining the /person/checkStatus GET endpoint and its associated parameters and response schemas.

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "RocketReach API",
    "version": "1.0.0",
    "description": "The RocketReach API lets you search and retrieve contact info for 700M+ professionals and 35M\n    companies. Manage API settings, track usage, and find your API key on the account page.\n    All API calls require authentication via API key.\n    If you have any questions, please reach out to our team at api@rocketreach.co.\n    </br><span style=\"font-size:1.8rem; pass\">Quickstart</span>\n        1. Create an API key: Select “Generate New API Key” on your Account Settings page\n        2. Test API Key: You can test API endpoints directly in our documentation without writing a single line of code.\n            - Select an endpoint (GET /person/lookup for example)\n            - Select “Try It”\n            - Enter your API Key to send the request\n        3. Create Webhook (optional, but recommended): We offer a webhook solution for person lookups so clients do not need to poll the check status endpoint until their results are available.\n            - To set up a webhook, go to your API settings. Enter your server's callback URL into the field, and hit \"Create\".\n            - For each URL created, you can perform some basic maintenance tasks:\n                - Test the webhook - we will attempt to send a basic JSON payload to the URL.\n                - Disable/enable - if you may use this URL in the future, this is an option to temporarily disable it.\n                - Delete - if you no longer plan using this URL, it can be deleted.\n    </br><span style=\"font-size:1.8rem;pass\">Rate Limits</span>\n        - [Rate Limits](../guides/rate-limits.md)\n    </br><span style=\"font-size:1.8rem; pass\">FAQ</span>\n        - [FAQ](../guides/faq.md)\n    ",
    "contact": {
      "name": "RocketReach Support",
      "email": "api@rocketreach.co"
    }
  },
  "paths": {
    "/person/checkStatus": {
      "get": {
        "operationId": "check_person_lookup_status",
        "description": "Check Person Lookup Status",
        "summary": "People Lookup Status API",
        "parameters": [
          {
            "in": "query",
            "name": "ids",
            "schema": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            },
            "description": "List of Profile IDs"
          }
        ],
        "tags": [
          "People Data API"
        ],
        "security": [
          {
            "RocketReachAPIKey": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProfileAPICompiledCompany"
                  }
                }
              }
            },
            "description": "Success. Returns the status and profile data of the requested profiles."
          },
          "400": {
            "description": "Bad Request. The request is malformed or missing required parameters."
          },
          "401": {
            "description": "Unauthorized. API Key is missing or invalid."
          },
          "403": {
            "description": "Forbidden. API Key lacks permission to perform this action."
          },
          "404": {
            "description": "Not Found. The requested resource (e.g., profile) does not exist."
          },
          "429": {
            "description": "Too Many Requests. API request limit reached -- slow down requests."
          },
          "500": {
            "description": "Internal Server Error. Unexpected error on RocketReach servers. Try again later."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "EducationAPI": {
        "type": "object",
        "properties": {
          "major": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary field of study of the educational experience"
          },
          "school": {
            "type": [
              "string",
              "null"
            ],
            "description": "School/University of the educational experience"
          },
          "degree": {
            "type": [
              "string",
              "null"
            ],
            "description": "Degree obtained through the educational experience"
          },
          "start": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Start date of the educational experience"
          },
          "end": {
            "type": [
              "integer",
              "null"
            ],
            "description": "End date of the educational experience"
          }
        }
      },
      "JobHistoryAPICompiledCompany": {
        "type": "object"
```

--------------------------------

### Universal Bulk People Lookup

Source: https://docs.rocketreach.co/reference/create_universal_person_bulk_lookup

Documentation for the Universal Bulk People Lookup endpoint, which supports batch processing of person profiles.

```APIDOC
## POST /v1/bulk/person/lookup

### Description
Performs bulk lookups for person profiles. This endpoint is designed for large numbers of simultaneous lookups and requires at least 10 lookups per batch (up to 100). It requires a webhook URL or webhook ID to be specified.

### Method
POST

### Parameters
#### Query Parameters
- **reveal_professional_email** (boolean) - Optional - If true, reveals professional emails (2 credits).
- **reveal_personal_email** (boolean) - Optional - If true, reveals personal emails (3 credits).
- **reveal_phone** (boolean) - Optional - If true, reveals phone numbers (6 credits).
- **reveal_detailed_person_enrichment** (boolean) - Optional - If true, reveals detailed person enrichment (1 credit).
- **reveal_healthcare_enrichment** (boolean) - Optional - If true, reveals healthcare enrichment (1 credit).

#### Request Body
- **queries** (array) - Required - A list of lookup objects. Each object must contain at least one of: linkedin_url, profile_id, company and name, or email.
```

--------------------------------

### Search by Name

Source: https://docs.rocketreach.co/reference/create_universal_person_search

Performs a search for individuals matching the specified name.

```bash
    curl --request 'POST' --location 'https://api.rocketreach.co/v2/api/search'
     --header 'Api-Key: <YOUR API KEY>'
     --header 'Content-Type: application/json'
     --data '{"query":{"name":["Marc Benioff"]}}'
```

--------------------------------

### POST /bulkLookup

Source: https://docs.rocketreach.co/reference/bulk-person-lookup-person-lookup-api

Initiates a bulk lookup request for a batch of people. This endpoint requires at least 10 lookups and supports up to 100 per batch.

```APIDOC
## POST /bulkLookup

### Description
Bulk People Lookup by Criteria. This endpoint is suited for large numbers of simultaneous lookups and requires a webhook for result delivery.

### Method
POST

### Endpoint
/bulkLookup

### Request Body
- **queries** (array) - Required - A list of lookup queries. Each query must contain at least one of: linkedin_url, profile_id, company and name, or email.
- **webhook_id** (string) - Optional - The ID of a pre-configured webhook to receive results.
- **webhook_url** (string) - Optional - A callback URL to receive results.

### Response
#### Success Response (200)
- **RR-Request-ID** (string) - Lookup unique identifier, will also be sent in the header of webhook.
```

--------------------------------

### ping

Source: https://docs.rocketreach.co/reference/mcp-tools

A liveness check that returns the server name and version to verify connectivity and authentication.

```APIDOC
## ping

### Description
Liveness check. Returns the server name and version. Useful for verifying connectivity and auth before making tool calls.

### Response
{
  "name": "rr-mcp-server",
  "version": "1.0.0",
  "message": "pong"
}
```

--------------------------------

### POST /mcp-oauth/register

Source: https://docs.rocketreach.co/reference/mcp-auth

Performs Dynamic Client Registration (RFC 7591) to obtain a client_id.

```APIDOC
## POST /mcp-oauth/register

### Description
Registers the client dynamically to receive a client_id for subsequent OAuth flows.

### Method
POST

### Endpoint
https://rocketreach.co/mcp-oauth/register
```

--------------------------------

### Set API Server URL

Source: https://docs.rocketreach.co/reference/create_universal_person_lookup

Base URL configuration for the v2 production API server.

```json
"servers": [
    {
      "url": "https://api.rocketreach.co/api/v2",
      "description": "v2 Production Server"
    }
  ]
```

--------------------------------

### Authentication

Source: https://docs.rocketreach.co/reference/create_universal_person_bulk_lookup

Details on how to authenticate requests to the RocketReach API using an API key.

```APIDOC
## Authentication

### Description
Requests to the RocketReach API are authenticated using the `Api-Key` request header. You can locate your API Key from the "My API Key" section of the [API account page](https://rocketreach.co/account?section=nav_gen_api).

### Note
Older clients may use an `api_key` query parameter, but this behavior is deprecated.
```

--------------------------------

### Authentication

Source: https://docs.rocketreach.co/reference/company-search-api

Details on how to authenticate requests to the RocketReach API using an API key.

```APIDOC
## Authentication

### Description
Requests to the API are authenticated using the Api-Key request header. You can locate your API Key from the "My API Key" section of the [API account page](https://rocketreach.co/account?section=nav_gen_api).

### Security Scheme
- **Name**: Api-Key
- **In**: header
- **Type**: apiKey
```
Tokens:
Raw