# RocketReach — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://orthogonal.com/llms.txt) · [browse all APIs](https://orthogonal.com/discover)

Search and retrieve contact info for 700M+ professionals and 60M+ companies. Lookup emails, phone numbers, job history, education, and more via the Universal Credits API.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://orthogonal.com/dashboard/settings/api-keys

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "price": "<usd>", "data": { ... } }`.

## Endpoints

### Universal People Search

Search 700M+ professional profiles by name, company, title, location, skills, and many more criteria. Returns a paginated list of matching profiles (without contact info). Use People Lookup to get contact details.

`POST /universal/person/search`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | object | Yes | Search query object with filters like name, keyword, current_employer, current_title, location, skills, company_domain, etc. |
| `start` | integer | No | Paginate results starting from this value (1-based, max 10000). |
| `page_size` | integer | No | Results per page (1-100, default 100). |
| `order_by` | string | No | Sort order: relevance, popularity, or score. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/person/search","body":{"query":"<object>","start":"<integer>","page_size":"<integer>","order_by":"<string>"}}'
```

### Universal People Lookup

Look up a person by name, email, LinkedIn URL, or other identifiers. Returns contact info including emails, phones, job history, education, and skills. Requires at least one reveal_* enrichment parameter.

`GET /universal/person/lookup`

**Estimated cost:** $0.227

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Name of the person. Must be used with current_employer. |
| `current_employer` | string | No | Current employer. Must be used with name. |
| `email` | string | No | Email address for the person. |
| `linkedin_url` | string | No | LinkedIn profile URL. |
| `id` | integer | No | RocketReach internal profile ID. |
| `phone` | string | No | Phone number in E.164 or international format. |
| `npi_number` | integer | No | NPI number for US healthcare professionals. |
| `title` | string | No | Job title of the person. |
| `reveal_professional_email` | boolean | No | Reveal professional email (2 credits/profile). |
| `reveal_personal_email` | boolean | No | Reveal personal email (3 credits/profile). |
| `reveal_phone` | boolean | No | Reveal phone number (6 credits/profile). |
| `reveal_detailed_person_enrichment` | boolean | No | Reveal detailed enrichment (1 credit/profile). |
| `reveal_healthcare_enrichment` | boolean | No | Reveal healthcare enrichment (1 credit/profile). |
| `webhook_id` | integer | No | Webhook ID for async result delivery. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/person/lookup","method":"GET","query":{"name":"<string>","current_employer":"<string>","email":"<string>","linkedin_url":"<string>","id":"<integer>","phone":"<string>","npi_number":"<integer>","title":"<string>","reveal_professional_email":"<boolean>","reveal_personal_email":"<boolean>","reveal_phone":"<boolean>","reveal_detailed_person_enrichment":"<boolean>","reveal_healthcare_enrichment":"<boolean>","webhook_id":"<integer>"}}'
```

### Universal Company Search

Search millions of company records by name, domain, industry, location, revenue, employee count, funding, tech stack, hiring signals, intent data, and more. Returns paginated list of matching companies.

`POST /universal/company/search`

**Estimated cost:** $0.227

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | object | Yes | Search query object with filters like name, domain, industry, location, employees, revenue, techstack, intent, news_signal, etc. |
| `start` | integer | No | Paginate results starting from this value (1-based). |
| `page_size` | integer | No | Results per page (1-100, default 100). |
| `order_by` | string | No | Sort order for results. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/company/search","body":{"query":"<object>","start":"<integer>","page_size":"<integer>","order_by":"<string>"}}'
```

### Universal Bulk People Lookup

Batch lookup up to 100 people simultaneously. Requires a webhook for result delivery. Minimum 10 lookups per batch. Each query accepts the same identifiers as single lookup (name+employer, email, linkedin_url, etc.).

`POST /universal/person/bulk_lookup`

**Estimated cost:** $0.227

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `queries` | array | Yes | Array of 10-100 lookup queries. Each query can have: name, current_employer, linkedin_url, email, phone, id, reveal_professional_email, reveal_personal_email, reveal_phone, etc. |
| `webhook_id` | integer | No | Webhook ID for result delivery. |
| `profile_list` | string | No | Add results to this profile list. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/person/bulk_lookup","body":{"queries":"<array>","webhook_id":"<integer>","profile_list":"<string>"}}'
```

### Universal People Lookup Status

Check the status of one or more person lookup requests. Returns status (complete, failed, waiting, searching, progress) and results when complete.

`GET /universal/person/check_status`

**Estimated cost:** $0

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ids` | array | Yes | Array of profile IDs to check status for. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/person/check_status","method":"GET","query":{"ids":"<array>"}}'
```

### Universal Company Lookup

Look up a company by domain, name, LinkedIn URL, ticker symbol, or RocketReach ID. Returns company metadata including industry, location, employee count, funding, and more.

`GET /universal/company/lookup`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Domain of the company (preferred identifier). |
| `name` | string | No | Name of the company. |
| `linkedin_url` | string | No | LinkedIn URL of the company. |
| `id` | integer | No | RocketReach internal company ID. |
| `ticker` | string | No | Stock ticker symbol. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/universal/company/lookup","method":"GET","query":{"domain":"<string>","name":"<string>","linkedin_url":"<string>","id":"<integer>","ticker":"<string>"}}'
```

### People Search

Search for people by various criteria including name, title, company, location, and more. Returns paginated results. Consumes 1 export credit per page.

`POST /person/search`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | object | Yes | Search query with filters like name, keyword, current_employer, current_title, location, etc. |
| `start` | integer | No | Pagination start offset |
| `page_size` | integer | No | Number of results per page (max 100) |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/person/search","body":{"query":"<object>","start":"<integer>","page_size":"<integer>"}}'
```

### Bulk People Lookup

Look up multiple people in a single request. Consumes 1 export credit per person.

`POST /bulkLookup`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `queries` | array | Yes | Array of lookup queries, each containing identifiers like name, current_employer, linkedin_url, etc. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/bulkLookup","body":{"queries":"<array>"}}'
```

### People and Company Lookup

Look up a person and their associated company data in a single request. Consumes 1 export credit.

`GET /profile-company/lookup`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Full name of the person |
| `current_employer` | string | No | Current employer name |
| `linkedin_url` | string | No | LinkedIn profile URL |
| `email` | string | No | Email address |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/profile-company/lookup","method":"GET","query":{"name":"<string>","current_employer":"<string>","linkedin_url":"<string>","email":"<string>"}}'
```

### Company Search

Search for companies by name, domain, industry, location, size, revenue, and more. Returns paginated results. Consumes 1 export credit per page.

`POST /searchCompany`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | object | Yes | Search query with filters like name, domain, industry, location, num_employees, revenue, etc. |
| `start` | integer | No | Pagination start offset |
| `page_size` | integer | No | Number of results per page (max 100) |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/searchCompany","body":{"query":"<object>","start":"<integer>","page_size":"<integer>"}}'
```

### People Lookup Status

Check the status of a pending person lookup request. Free, no credit cost.

`GET /person/checkStatus`

**Estimated cost:** $0

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | integer | Yes | The lookup ID returned from a person lookup request |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/person/checkStatus","method":"GET","query":{"id":"<integer>"}}'
```

### People Lookup

Look up a person by name, email, LinkedIn URL, or other identifiers. Returns professional profile and contact information. Consumes 1 export credit.

`GET /person/lookup`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Full name of the person |
| `current_employer` | string | No | Current employer name |
| `current_title` | string | No | Current job title |
| `linkedin_url` | string | No | LinkedIn profile URL |
| `email` | string | No | Email address |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/person/lookup","method":"GET","query":{"name":"<string>","current_employer":"<string>","current_title":"<string>","linkedin_url":"<string>","email":"<string>"}}'
```

### Company Lookup

Look up a company by name, domain, or ID. Returns company profile including industry, size, location, revenue, and more. Consumes 1 export credit.

`GET /company/lookup/`

**Estimated cost:** $0.113

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Company name |
| `domain` | string | No | Company domain (e.g. google.com) |
| `id` | integer | No | RocketReach company ID |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"rocketreach","path":"/company/lookup/","method":"GET","query":{"name":"<string>","domain":"<string>","id":"<integer>"}}'
```

---

Full details and an interactive quickstart: https://orthogonal.com/discover/rocketreach