---
name: orthogonal-scalelist
description: "Call Scalelist through Orthogonal's pay-per-use Run API: Scalelist finds verified work emails and direct mobile numbers for B2B contacts, finds emails at a company by domain, and searches and counts people by title, seniority, industry, location and company. Single lookups answer immediately; bulk calls take up to 100 leads and return a task id to poll. Charged on results, not attempts."
---

# Scalelist — 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://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Scalelist finds verified work emails and direct mobile numbers for B2B contacts, finds emails at a company by domain, and searches and counts people by title, seniority, industry, location and company. Single lookups answer immediately; bulk calls take up to 100 leads and return a task id to poll. Charged on results, not attempts.

**Verified:** no

## Access

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

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

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, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Service status

A quick yes or no on whether the API is working right now.

Open to anyone: no API key, no credits, no rate limit.

### What you get back

One word. **ok** means lookups should work normally, **degraded** means they may be slow or fail. Alert on **degraded**.

`GET /health`

**Cost:** Free. Calls cost nothing.

**Page:** https://www.orthogonal.com/api/scalelist/0c53190a-e228-4b8c-b209-f2860017bfbb

**Docs:** https://api.scalelist.com/docs

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/health","method":"GET"}'
```

### Work email finder

Use this endpoint to find the work email of any B2B person:

- Work email (1 credit, charged only when we find one)

### Input needed

You must provide either:

1. `first_name` + `last_name` and a company (`company_domain` or `company_name`)
2. `full_name` and a company (`company_domain` or `company_name`)
3. `linkedin_profile_url`, on its own or with either of the above

### Practical tips

Send `company_domain` rather than `company_name` where you have it. We look a name up before we can search, which is one more thing to get wrong.

With a name, a company and a LinkedIn profile, a "Not found" answer takes longer, because the profile is searched too.

For a list, use `POST /email/find/bulk` instead of calling this in a loop. One call takes 100 people and does not spend your per-minute allowance.

### What you get back

The email address, plus a `status`: **Valid** (verified, safe to send), **Risky** (the company accepts mail for any address, so we could not confirm this one), or **No

`POST /api/v1/email/find/single`

**Cost:** Priced by usage. Response-based: you pay for what the call uses, read from the response. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.06322 per call
- A call that returns nothing costs $0
- If you pay with a wallet (x402, MPP or Nanopayments), you pay this request's price before the call, not the final price from the response

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/fc14eb19-05ab-4836-b7e4-b77c686ce194

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | Their first name. Send this (last_name is optional), or send full_name instead. |
| `last_name` | string | No | Their last name. Optional, so leave it out if you do not have it. |
| `full_name` | string | No | First and last name together, if that is how you store them. |
| `company_domain` | string | No | Where they work, as a website, for example scalelist.com. Send this or company_name, whichever you have. |
| `company_name` | string | No | Where they work, by name. |
| `custom` | object | No | Anything you want handed back untouched with the result: a row id, a list name. We ignore it otherwise. |
| `linkedin_profile_url` | string | No | A link to their LinkedIn profile. Enough on its own, with no name or company. |
| `sync` | boolean | No | Leave it alone to get the answer in the response. Set it to false and we reply straight away, then deliver the result to your webhook_url. |
| `webhook_url` | string | No | Where we POST the result when it is ready, so you do not have to wait on the call. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/email/find/single","body":{"first_name":"<string>","last_name":"<string>","full_name":"<string>","company_domain":"<string>","company_name":"<string>","custom":"<object>","linkedin_profile_url":"<string>","sync":"<boolean>","webhook_url":"<string>"}}'
```

### Bulk email results

Check the status and collect the results of a bulk email task.

Polling does not consume credits.

### What you get back

`status` is `queued`, `processing`, `done`, `partial` (some failed) or `failed`. Once `done`, `results` holds one row per person you sent, in order, each shaped like a single lookup. Anyone we could not find has `email: null` and costs nothing. Before then, `results` is `null`.

`GET /api/v1/email/find/bulk`

**Cost:** Free. Calls cost nothing.

**Page:** https://www.orthogonal.com/api/scalelist/a079f851-c1c1-4350-8c15-133abbae5d90

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `task_id` | string | Yes | Task id returned by `POST /email/find/bulk`. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/email/find/bulk","method":"GET","query":{"task_id":"<string>"}}'
```

### Bulk email finder

Use this endpoint to find work emails for up to 100 people in one call:

- Work email (1 credit each, charged only when we find one)

### Input needed

You must provide either:

1. a `requests` list of up to 100 people, each one shaped exactly like a single lookup

### Practical tips

Put a `custom` object on each person and we hand it back untouched with their result. A row id or a CRM id there is what lets you match results to records without guessing.

Give us a `webhook_url` and we will post the results to you. Polling works too, but you have to keep asking.

Send an `Idempotency-Key` header. If a call times out and you retry, we return the original task rather than starting a second one and charging twice.

### What you get back

A `task_id`. The work is queued, not done. Collect the results by polling `GET /email/find/bulk?task_id=…`, or send a `webhook_url` and we will post them to you.

`POST /api/v1/email/find/bulk`

**Cost:** From $0.06322 per call. Request-based: the price depends on what you send. You see it before you run. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.06322 per person, 1 to 100 people
- At most $6.322 per call

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/cc1c085a-e46e-4440-b712-2e042dff6b0c

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `requests` | object | Yes | The people to look up, up to 100 in one call. Each one is described the same way as a single lookup. |
| `webhook_url` | string | No | Where we POST the results when the batch finishes. Without one, poll `GET /email/find/bulk?task_id=...` instead. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/email/find/bulk","body":{"requests":"<object>","webhook_url":"<string>"}}'
```

### Mobile number finder

Use this endpoint to find the direct mobile number of any B2B person:

- Mobile number (10 credits, charged only when we find one)

### Input needed

You must provide either:

1. `linkedin_profile_url` or `linkedin_id`
2. `email`
3. a name (`first_name` + `last_name`, or `full_name`) and a company (`company_domain` or `company_name`)

### Practical tips

A LinkedIn profile URL matches best. Where you have one, send it even alongside the name and company.

`job_title` and `city` are optional. They earn their place when two people at the same company share a name.

### What you get back

A mobile number in international format, and a `status` of `found` or `not_found`.

`POST /api/v1/phone/find/single`

**Cost:** Up to $0.6322 per call. Response-based: you pay for what the call uses, read from the response, never more than $0.6322 per call. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- At most $0.6322 per call
- If you pay with a wallet (x402, MPP or Nanopayments), you pay this request's price before the call, not the final price from the response

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/743edb18-4343-472d-9cb8-214e5c4bfef6

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | Their first name. Not enough on its own, so pair it with a company, or send a LinkedIn profile or email instead. |
| `last_name` | string | No | Their last name. Optional, so leave it out if you do not have it. |
| `full_name` | string | No | First and last name together, if that is how you store them. |
| `company_domain` | string | No | Where they work, as a website, for example scalelist.com. Send this or company_name, whichever you have. |
| `company_name` | string | No | Where they work, by name. Send this or company_domain, whichever you have. |
| `email` | string | No | Their work email, if you already have it. Enough on its own, and it sharpens the match when sent alongside other details. |
| `linkedin_profile_url` | string | No | A link to their LinkedIn profile. The most accurate way to ask, and enough on its own. |
| `linkedin_id` | string | No | The id LinkedIn uses for the person internally. Enough on its own, if you happen to have it. |
| `job_title` | string | No | Optional. Helps when two people at the same company share a name. |
| `city` | string | No | Optional. Helps when people with the same name work in different places. |
| `custom` | object | No | Anything you want handed back untouched with the result: a row id, a list name. We ignore it otherwise. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/phone/find/single","body":{"first_name":"<string>","last_name":"<string>","full_name":"<string>","company_domain":"<string>","company_name":"<string>","email":"<string>","linkedin_profile_url":"<string>","linkedin_id":"<string>","job_title":"<string>","city":"<string>","custom":"<object>"}}'
```

### Bulk mobile results

Check the status and collect the results of a bulk phone task.

Polling does not consume credits.

### What you get back

The same envelope as the email batch poll: a `status`, and once `done`, one `results` row per person you sent.

`GET /api/v1/phone/find/bulk`

**Cost:** Free. Calls cost nothing.

**Page:** https://www.orthogonal.com/api/scalelist/8c95a495-ce0c-4234-afdf-146b3fa2f424

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `task_id` | string | Yes | Task id returned by `POST /phone/find/bulk`. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/phone/find/bulk","method":"GET","query":{"task_id":"<string>"}}'
```

### Bulk mobile finder

Find up to 100 mobile numbers in one call. Returns a task id straight away; results arrive later.

• Supply `webhook_url` and the results are POSTed there when the batch finishes.
• Or poll `GET /phone/find/bulk?task_id=<task_id>` whenever you like.

**10 credits per number found.** Send an `Idempotency-Key` header to make retries safe for 24h.

### Input needed

You must provide either:

1. a `requests` list of up to 100 people, each one shaped exactly like a single lookup

### Practical tips

Mobile numbers are the slowest thing we look up, roughly 4 seconds each. A full batch of 100 takes minutes, so use a `webhook_url` rather than waiting on a poll.

Put a `custom` object on each person to match results back to your own records.

### What you get back

A `task_id`. Collect the numbers by polling `GET /phone/find/bulk?task_id=…`, or send a `webhook_url` and we will post them to you.

`POST /api/v1/phone/find/bulk`

**Cost:** From $0.6322 per call. Request-based: the price depends on what you send. You see it before you run. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.6322 per person, 1 to 100 people
- At most $63.22 per call

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/55147c30-8bc6-4928-8dec-fc70e6747f39

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `requests` | object | Yes | The people to look up, up to 100 in one call. Each one is described the same way as a single lookup. |
| `webhook_url` | string | No | Where we POST the results when the batch finishes. Without one, poll `GET /phone/find/bulk?task_id=...` instead. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/phone/find/bulk","body":{"requests":"<object>","webhook_url":"<string>"}}'
```

### Company email finder

Find the professional emails Scalelist knows at a company, with no names needed.

Provide `company_domain`, or `company_name` to look the domain up for you, using the same two field names every other endpoint uses. `limit` caps how many come back (default 10, max 100).

**1 credit per email returned.**

### Input needed

You must provide either:

1. `company_domain`, the company website, for example scalelist.com
2. `company_name`, which we look the domain up from

### Practical tips

`limit` caps how many come back, and you are charged per email returned. Ask for 10 before you ask for 100.

### What you get back

A list of contacts at that company, each with the email, the person's name, and their job title where we know it - and the same `status` a single lookup gives you: **Valid**, **Risky** or **Not found**. `total` is how many we hold; `limit` is how many this call returned. You are charged 1 credit per email returned.

`POST /api/v1/email/find/domain`

**Cost:** $0.06322 per unit. Response-based: you pay for the units the call uses, read from the response. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.06322 per unit
- A call that returns nothing costs $0
- If you pay with a wallet (x402, MPP or Nanopayments), you pay this request's price before the call, not the final price from the response

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/3dff0d13-a9b9-4dd9-b840-f80282bbaeb8

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_domain` | string | No | Where they work, as a website, for example scalelist.com. Send this or company_name, whichever you have. |
| `company_name` | string | No | Where they work, by name. |
| `limit` | integer | No | Maximum number of emails to return. |
| `webhook_url` | string | No | Where we POST the results when the lookup finishes. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/email/find/domain","body":{"company_domain":"<string>","company_name":"<string>","limit":"<integer>","webhook_url":"<string>"}}'
```

### People search

Build an audience: find people by job title, seniority, industry, location, company and more.

At least one filter is required. Page through results with `page`.

**How filters combine.** Values inside one list are OR; separate fields are AND. So `industries: ["Banking", "Insurance"]` matches either, and adding `seniority` narrows that set rather than widening it. Locations behave the same way across city, state and country: `[{city: "Paris"}, {country: "Germany"}]` means Paris **or** Germany, never both at once.

**1 credit per profile returned**, up to 100 per page.

Tip: size your audience first with `POST /people/count`.

### Input needed

You must provide either:

1. at least one filter, for example `job_titles`, `seniority`, `industries` or `locations`

### Practical tips

Values inside one filter are OR, separate filters are AND. `industries: ["Banking", "Insurance"]` matches either; adding `seniority` narrows that set rather than widening it.

Check your industry wording with `

`POST /api/v1/people/search`

**Cost:** $0.06322 per profile returned. Response-based: you pay for what comes back, never more than the price shown before you run. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.06322 per profile returned, 1 to 100 profiles
- A call that returns nothing costs $0
- If you pay with a wallet (x402, MPP or Nanopayments), you pay this request's price before the call, not the final price from the response

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/7402e03c-f3ce-4075-a007-23245f193ea2

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_titles` | string | No | Job titles to match. Give several and we match anyone holding any of them, e.g. ["CTO", "VP of Engineering"]. |
| `seniority` | string | No | How senior they are. Give several to match any of them. Accepted values: Owner / Founder, CXO, Partner, VP, Head, Director, Manager, Senior, Entry, Intern. |
| `job_functions` | string | No | The part of the business they work in. Give several to match any of them. Accepted values: Operations, Business Development, Sales, Education, Engineering, Healthcare Services, Information Technology, Administrative, Arts and Design, Customer Success and Support, Finance, Community and Social Services, Media and Communication, Accounting, Marketing, Human Resources, Research, Program and Project Management, Legal, Military and Protective Services, Consulting, Entrepreneurship, Real Estate, Quali |
| `industries` | string | No | The industry their company is in. Give several to match any of them. Check your wording first with POST /people/industries/resolve, e.g. Defense & Space, Computer Hardware, Computer Software, Computer Networking, Internet, Semiconductors. |
| `locations` | object | No | Where they are. Each entry names a city, state or country; give several to match any of them. |
| `company_size` | object | No | How big their company is, by employee count. Either end can be left out. |
| `keywords` | string | No | Free-text keywords, OR logic: a person matches if ANY term appears on their profile. |
| `years_of_experience` | object | No | Total years of professional experience: { min, max }. Either bound optional. |
| `years_in_current_role` | object | No | Years at the current employer: { min, max }. Either bound optional. |
| `recently_changed_jobs` | boolean | No | Only people whose current role started in roughly the last 3 months. High-intent buying signal. |
| `open_to` | string | No | Person-level buying signals from their own profile badges, e.g. ["hiring"]. |
| `skills` | string | No | Skills listed on the profile, e.g. ["Lead Generation", "Python"]. Search results do not show skills. |
| `schools` | string | No | Schools or universities attended, e.g. ["Stanford", "HEC Paris"]. |
| `languages` | string | No | Languages the person speaks, e.g. ["French", "German"]. |
| `certifications` | string | No | Certifications held, e.g. ["PMP"]. Search results do not show certifications. |
| `min_followers` | integer | No | Only people with at least this many LinkedIn followers. |
| `companies` | string | No | Company names, e.g. ["Scalelist", "Datadog"]. |
| `company_domains` | string | No | Company domains, e.g. ["scalelist.com"]. |
| `company_hq_countries` | string | No | Country where the current employer is headquartered. Full English name or ISO alpha-3 code, e.g. ["Germany", "USA"]. |
| `company_type` | string | No | Company category filter, e.g. ["public company"] or ["non-profit"]. |
| `past_companies` | string | No | Companies the person previously worked at, by name. With past_job_titles / past_seniority, all must hold for the SAME past role. |
| `past_job_titles` | string | No | Job titles held in a past role, e.g. ["Founder"]. With past_companies / past_seniority, all must hold for the SAME past role. |
| `past_seniority` | string | No | Career level of a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_titles` | string | No | Job titles to exclude from results. |
| `exclude_seniority` | string | No | Career levels to exclude (current role). One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_functions` | string | No | Job functions to exclude (current role). Resolved like `job_functions`; a value with no matching function is refused with 422. |
| `exclude_industries` | string | No | Industries to exclude (current employer). Resolved like `industries`; a word with no matching industry is refused with 422. |
| `exclude_locations` | object | No | Locations to exclude, same shape as `locations`. Example: "US except California". |
| `exclude_keywords` | string | No | Free-text keywords to exclude: a person is dropped if any term appears on their profile. |
| `exclude_companies` | string | No | Company names to exclude from results. |
| `exclude_company_domains` | string | No | Company websites to exclude from results, e.g. ["scalelist.com"]. |
| `exclude_company_hq_countries` | string | No | Drop people whose current employer is headquartered in any of these countries. Full English name or ISO alpha-3 code. |
| `exclude_past_companies` | string | No | Drop anyone who previously worked at any of these companies, by name. |
| `exclude_past_job_titles` | string | No | Drop anyone who held any of these job titles in a past role. |
| `exclude_past_seniority` | string | No | Drop anyone who held any of these career levels in a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_skills` | string | No | Drop anyone who lists any of these skills. |
| `exclude_schools` | string | No | Drop anyone who attended any of these schools. |
| `exclude_languages` | string | No | Drop anyone who lists any of these languages. |
| `exclude_certifications` | string | No | Drop anyone who holds any of these certifications. |
| `page` | integer | No | Which page of results to return. Starts at 1. |
| `page_size` | integer | No | Profiles per page (max 100). Billed 1 credit per profile returned. |
| `offset` | integer | No | Absolute row offset for the window; overrides page when set. Exactly [offset, offset + page_size) is returned and billed. |
| `cursor` | string | No | Bookmark returned as `next_cursor` by the previous page. Pass it when walking pages sequentially, since it is the cheapest and most stable way to page. Without it, page/offset addressing still works. |
| `job_title_match` | string | No | How job_titles match: "words" (default) = all words in any order; "phrase" = the exact phrase inside the title, and "President" / "Owner" / "Controller" asks drop look-alikes (Vice President, Product Owner, IT Controller). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/people/search","body":{"job_titles":"<string>","seniority":"<string>","job_functions":"<string>","industries":"<string>","locations":"<object>","company_size":"<object>","keywords":"<string>","years_of_experience":"<object>","years_in_current_role":"<object>","recently_changed_jobs":"<boolean>","open_to":"<string>","skills":"<string>","schools":"<string>","languages":"<string>","certifications":"<string>","min_followers":"<integer>","companies":"<string>","company_domains":"<string>","company_hq_countries":"<string>","company_type":"<string>","past_companies":"<string>","past_job_titles":"<string>","past_seniority":"<string>","exclude_job_titles":"<string>","exclude_seniority":"<string>","exclude_job_functions":"<string>","exclude_industries":"<string>","exclude_locations":"<object>","exclude_keywords":"<string>","exclude_companies":"<string>","exclude_company_domains":"<string>","exclude_company_hq_countries":"<string>","exclude_past_companies":"<string>","exclude_past_job_titles":"<string>","exclude_past_seniority":"<string>","exclude_skills":"<string>","exclude_schools":"<string>","exclude_languages":"<string>","exclude_certifications":"<string>","page":"<integer>","page_size":"<integer>","offset":"<integer>","cursor":"<string>","job_title_match":"<string>"}}'
```

### People count

See how many people match your filters before you pay for any profiles.

Takes the same filters as `POST /people/search`, minus pagination.

Costs **1 credit per call**, however large the audience. Sizing an
audience of 40,000 people still costs 1. `credits_charged` on the
response says what you paid.

### Input needed

You must provide either:

1. at least one filter, the same ones `POST /people/search` takes

### Practical tips

A count with no filter would be the size of the whole database, so at least one is required.

Counting costs 1 credit however large the audience. Size it once and reuse the number.

### What you get back

The size of the audience, and what the call cost.

`POST /api/v1/people/count`

**Cost:** $0.06322 per call. Fixed: every call costs the same. You aren't charged for failed calls. A wallet payment for a failed call is refunded.

**Page:** https://www.orthogonal.com/api/scalelist/9da05baa-07bd-4c67-8b44-ee99bdd503f8

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_titles` | string | No | Job titles to match. Give several and we match anyone holding any of them, e.g. ["CTO", "VP of Engineering"]. |
| `seniority` | string | No | How senior they are. Give several to match any of them. Accepted values: Owner / Founder, CXO, Partner, VP, Head, Director, Manager, Senior, Entry, Intern. |
| `job_functions` | string | No | The part of the business they work in. Give several to match any of them. Accepted values: Operations, Business Development, Sales, Education, Engineering, Healthcare Services, Information Technology, Administrative, Arts and Design, Customer Success and Support, Finance, Community and Social Services, Media and Communication, Accounting, Marketing, Human Resources, Research, Program and Project Management, Legal, Military and Protective Services, Consulting, Entrepreneurship, Real Estate, Quali |
| `industries` | string | No | The industry their company is in. Give several to match any of them. Check your wording first with POST /people/industries/resolve, e.g. Defense & Space, Computer Hardware, Computer Software, Computer Networking, Internet, Semiconductors. |
| `locations` | object | No | Where they are. Each entry names a city, state or country; give several to match any of them. |
| `company_size` | object | No | How big their company is, by employee count. Either end can be left out. |
| `keywords` | string | No | Free-text keywords, OR logic: a person matches if ANY term appears on their profile. |
| `years_of_experience` | object | No | Total years of professional experience: { min, max }. Either bound optional. |
| `years_in_current_role` | object | No | Years at the current employer: { min, max }. Either bound optional. |
| `recently_changed_jobs` | boolean | No | Only people whose current role started in roughly the last 3 months. High-intent buying signal. |
| `open_to` | string | No | Person-level buying signals from their own profile badges, e.g. ["hiring"]. |
| `skills` | string | No | Skills listed on the profile, e.g. ["Lead Generation", "Python"]. Search results do not show skills. |
| `schools` | string | No | Schools or universities attended, e.g. ["Stanford", "HEC Paris"]. |
| `languages` | string | No | Languages the person speaks, e.g. ["French", "German"]. |
| `certifications` | string | No | Certifications held, e.g. ["PMP"]. Search results do not show certifications. |
| `min_followers` | integer | No | Only people with at least this many LinkedIn followers. |
| `companies` | string | No | Company names, e.g. ["Scalelist", "Datadog"]. |
| `company_domains` | string | No | Company domains, e.g. ["scalelist.com"]. |
| `company_hq_countries` | string | No | Country where the current employer is headquartered. Full English name or ISO alpha-3 code, e.g. ["Germany", "USA"]. |
| `company_type` | string | No | Company category filter, e.g. ["public company"] or ["non-profit"]. |
| `past_companies` | string | No | Companies the person previously worked at, by name. With past_job_titles / past_seniority, all must hold for the SAME past role. |
| `past_job_titles` | string | No | Job titles held in a past role, e.g. ["Founder"]. With past_companies / past_seniority, all must hold for the SAME past role. |
| `past_seniority` | string | No | Career level of a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_titles` | string | No | Job titles to exclude from results. |
| `exclude_seniority` | string | No | Career levels to exclude (current role). One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_functions` | string | No | Job functions to exclude (current role). Resolved like `job_functions`; a value with no matching function is refused with 422. |
| `exclude_industries` | string | No | Industries to exclude (current employer). Resolved like `industries`; a word with no matching industry is refused with 422. |
| `exclude_locations` | object | No | Locations to exclude, same shape as `locations`. Example: "US except California". |
| `exclude_keywords` | string | No | Free-text keywords to exclude: a person is dropped if any term appears on their profile. |
| `exclude_companies` | string | No | Company names to exclude from results. |
| `exclude_company_domains` | string | No | Company websites to exclude from results, e.g. ["scalelist.com"]. |
| `exclude_company_hq_countries` | string | No | Drop people whose current employer is headquartered in any of these countries. Full English name or ISO alpha-3 code. |
| `exclude_past_companies` | string | No | Drop anyone who previously worked at any of these companies, by name. |
| `exclude_past_job_titles` | string | No | Drop anyone who held any of these job titles in a past role. |
| `exclude_past_seniority` | string | No | Drop anyone who held any of these career levels in a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_skills` | string | No | Drop anyone who lists any of these skills. |
| `exclude_schools` | string | No | Drop anyone who attended any of these schools. |
| `exclude_languages` | string | No | Drop anyone who lists any of these languages. |
| `exclude_certifications` | string | No | Drop anyone who holds any of these certifications. |
| `job_title_match` | string | No | How job_titles match: "words" (default) = all words in any order; "phrase" = the exact phrase inside the title, and "President" / "Owner" / "Controller" asks drop look-alikes (Vice President, Product Owner, IT Controller). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/people/count","body":{"job_titles":"<string>","seniority":"<string>","job_functions":"<string>","industries":"<string>","locations":"<object>","company_size":"<object>","keywords":"<string>","years_of_experience":"<object>","years_in_current_role":"<object>","recently_changed_jobs":"<boolean>","open_to":"<string>","skills":"<string>","schools":"<string>","languages":"<string>","certifications":"<string>","min_followers":"<integer>","companies":"<string>","company_domains":"<string>","company_hq_countries":"<string>","company_type":"<string>","past_companies":"<string>","past_job_titles":"<string>","past_seniority":"<string>","exclude_job_titles":"<string>","exclude_seniority":"<string>","exclude_job_functions":"<string>","exclude_industries":"<string>","exclude_locations":"<object>","exclude_keywords":"<string>","exclude_companies":"<string>","exclude_company_domains":"<string>","exclude_company_hq_countries":"<string>","exclude_past_companies":"<string>","exclude_past_job_titles":"<string>","exclude_past_seniority":"<string>","exclude_skills":"<string>","exclude_schools":"<string>","exclude_languages":"<string>","exclude_certifications":"<string>","job_title_match":"<string>"}}'
```

### Industry name lookup

Check which industry categories a search will actually match, before you run it.

Each word comes back as one of:
• `resolved`: with the exact category names a search will filter on
• `unresolved`: no matching category, so a search would match it as profile text instead; `suggestions` lists nearby real categories
• `unverified`: the lookup failed, try again

### What you get back

Each word sorted into three buckets. `resolved` gives the real categories a search will filter on. `unresolved` means no category matched, so a search would match the word as free text; `suggestions` offers nearby real ones. `unverified` means the lookup failed, so try again rather than rewording.

`POST /api/v1/people/industries/resolve`

**Cost:** Free. Calls cost nothing.

**Page:** https://www.orthogonal.com/api/scalelist/a4cfa503-47bf-4f66-a7a3-c266febb9ee8

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `industries` | string | Yes | The industry words you plan to search with, up to 20. We tell you which ones we file companies under. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/people/industries/resolve","body":{"industries":"<string>"}}'
```

### Bulk people results

Check the status and collect the merged results of a bulk people search.

Polling does not consume credits; profiles were billed as they were found.

### What you get back

Every profile found so far, merged and de-duplicated. `returned` is how many you have, `pages_fetched` how many pages completed. `status` is `done` when the whole audience has been walked, or `partial` when it stopped early, usually because credits ran out.

`GET /api/v1/people/search/bulk`

**Cost:** Free. Calls cost nothing.

**Page:** https://www.orthogonal.com/api/scalelist/3b6b8745-dea9-41dd-a9ef-0681ba3a97ec

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `task_id` | string | Yes | Task id from `POST /people/search/bulk`. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/people/search/bulk","method":"GET","query":{"task_id":"<string>"}}'
```

### Bulk people search

Pull a whole audience across many pages in one call. Returns a task id straight away; results arrive later.

Set `start_page`, and `end_page` to stop at a given page; omit it to pull everything that matches.

• The merged results are POSTed to your `webhook_url` on completion.
• Or poll `GET /people/search/bulk?task_id=<task_id>` whenever you like.

**1 credit per profile found.** Send an `Idempotency-Key` header to make retries safe for 24h.

### Input needed

You must provide either:

1. at least one filter, plus a `metadata` object carrying your `webhook_url`

### Practical tips

Set `max_results` to stop at an exact number. Without it a run delivers whole pages, so asking for 45 can hand you 50 and bill for 50.

Use `skip_first` to resume a run that stopped part-way through a page, so the overlap is neither re-sent nor charged twice.

### What you get back

A `task_id`. Results arrive at your `webhook_url` as each page completes, and the merged list is available any time from `GET

`POST /api/v1/people/search/bulk`

**Cost:** From $0.06322 per call. Request-based: the price depends on what you send. You see it before you run. You aren't charged for failed calls. A wallet payment for a failed call is refunded.
- $0.06322 per call
- At most $63.22 per call

Use `"dryRun": true` in the Run API request to see a request's price before calling.

**Page:** https://www.orthogonal.com/api/scalelist/5b5fd6ed-bdf2-405c-a41c-09321dbcac27

**Docs:** https://api.scalelist.com/docs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_titles` | string | No | Job titles to match. Give several and we match anyone holding any of them, e.g. ["CTO", "VP of Engineering"]. |
| `seniority` | string | No | How senior they are. Give several to match any of them. Accepted values: Owner / Founder, CXO, Partner, VP, Head, Director, Manager, Senior, Entry, Intern. |
| `job_functions` | string | No | The part of the business they work in. Give several to match any of them. Accepted values: Operations, Business Development, Sales, Education, Engineering, Healthcare Services, Information Technology, Administrative, Arts and Design, Customer Success and Support, Finance, Community and Social Services, Media and Communication, Accounting, Marketing, Human Resources, Research, Program and Project Management, Legal, Military and Protective Services, Consulting, Entrepreneurship, Real Estate, Quali |
| `industries` | string | No | The industry their company is in. Give several to match any of them. Check your wording first with POST /people/industries/resolve, e.g. Defense & Space, Computer Hardware, Computer Software, Computer Networking, Internet, Semiconductors. |
| `locations` | object | No | Where they are. Each entry names a city, state or country; give several to match any of them. |
| `company_size` | object | No | How big their company is, by employee count. Either end can be left out. |
| `keywords` | string | No | Free-text keywords, OR logic: a person matches if ANY term appears on their profile. |
| `years_of_experience` | object | No | Total years of professional experience: { min, max }. Either bound optional. |
| `years_in_current_role` | object | No | Years at the current employer: { min, max }. Either bound optional. |
| `recently_changed_jobs` | boolean | No | Only people whose current role started in roughly the last 3 months. High-intent buying signal. |
| `open_to` | string | No | Person-level buying signals from their own profile badges, e.g. ["hiring"]. |
| `skills` | string | No | Skills listed on the profile, e.g. ["Lead Generation", "Python"]. Search results do not show skills. |
| `schools` | string | No | Schools or universities attended, e.g. ["Stanford", "HEC Paris"]. |
| `languages` | string | No | Languages the person speaks, e.g. ["French", "German"]. |
| `certifications` | string | No | Certifications held, e.g. ["PMP"]. Search results do not show certifications. |
| `min_followers` | integer | No | Only people with at least this many LinkedIn followers. |
| `companies` | string | No | Company names, e.g. ["Scalelist", "Datadog"]. |
| `company_domains` | string | No | Company domains, e.g. ["scalelist.com"]. |
| `company_hq_countries` | string | No | Country where the current employer is headquartered. Full English name or ISO alpha-3 code, e.g. ["Germany", "USA"]. |
| `company_type` | string | No | Company category filter, e.g. ["public company"] or ["non-profit"]. |
| `past_companies` | string | No | Companies the person previously worked at, by name. With past_job_titles / past_seniority, all must hold for the SAME past role. |
| `past_job_titles` | string | No | Job titles held in a past role, e.g. ["Founder"]. With past_companies / past_seniority, all must hold for the SAME past role. |
| `past_seniority` | string | No | Career level of a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_titles` | string | No | Job titles to exclude from results. |
| `exclude_seniority` | string | No | Career levels to exclude (current role). One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_job_functions` | string | No | Job functions to exclude (current role). Resolved like `job_functions`; a value with no matching function is refused with 422. |
| `exclude_industries` | string | No | Industries to exclude (current employer). Resolved like `industries`; a word with no matching industry is refused with 422. |
| `exclude_locations` | object | No | Locations to exclude, same shape as `locations`. Example: "US except California". |
| `exclude_keywords` | string | No | Free-text keywords to exclude: a person is dropped if any term appears on their profile. |
| `exclude_companies` | string | No | Company names to exclude from results. |
| `exclude_company_domains` | string | No | Company websites to exclude from results, e.g. ["scalelist.com"]. |
| `exclude_company_hq_countries` | string | No | Drop people whose current employer is headquartered in any of these countries. Full English name or ISO alpha-3 code. |
| `exclude_past_companies` | string | No | Drop anyone who previously worked at any of these companies, by name. |
| `exclude_past_job_titles` | string | No | Drop anyone who held any of these job titles in a past role. |
| `exclude_past_seniority` | string | No | Drop anyone who held any of these career levels in a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training. |
| `exclude_skills` | string | No | Drop anyone who lists any of these skills. |
| `exclude_schools` | string | No | Drop anyone who attended any of these schools. |
| `exclude_languages` | string | No | Drop anyone who lists any of these languages. |
| `exclude_certifications` | string | No | Drop anyone who holds any of these certifications. |
| `custom` | object | No | Anything you want handed back untouched with the result: a row id, a list name. We ignore it otherwise. |
| `job_title_match` | string | No | How job_titles match: "words" (default) = all words in any order; "phrase" = the exact phrase inside the title, and "President" / "Owner" / "Controller" asks drop look-alikes (Vice President, Product Owner, IT Controller). |
| `metadata` | object | Yes | Where to send the results, and how much of the audience to walk. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"scalelist","path":"/api/v1/people/search/bulk","body":{"job_titles":"<string>","seniority":"<string>","job_functions":"<string>","industries":"<string>","locations":"<object>","company_size":"<object>","keywords":"<string>","years_of_experience":"<object>","years_in_current_role":"<object>","recently_changed_jobs":"<boolean>","open_to":"<string>","skills":"<string>","schools":"<string>","languages":"<string>","certifications":"<string>","min_followers":"<integer>","companies":"<string>","company_domains":"<string>","company_hq_countries":"<string>","company_type":"<string>","past_companies":"<string>","past_job_titles":"<string>","past_seniority":"<string>","exclude_job_titles":"<string>","exclude_seniority":"<string>","exclude_job_functions":"<string>","exclude_industries":"<string>","exclude_locations":"<object>","exclude_keywords":"<string>","exclude_companies":"<string>","exclude_company_domains":"<string>","exclude_company_hq_countries":"<string>","exclude_past_companies":"<string>","exclude_past_job_titles":"<string>","exclude_past_seniority":"<string>","exclude_skills":"<string>","exclude_schools":"<string>","exclude_languages":"<string>","exclude_certifications":"<string>","custom":"<object>","job_title_match":"<string>","metadata":"<object>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/scalelist
