> ## Documentation Index
> Fetch the complete documentation index at: https://docs.canvas.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# People

> Find people at companies by role, seniority, and department

Find people at known companies by job title, seniority level, and department. Also supports natural language people search when you don't have a specific company list.

**Credit cost:** 1 credit per person returned.

***

## Search at companies

Best when you already have companies and want to find specific roles at them.

### Example prompts

* "Find the CEO at Artisan and Spendflo"
* "Find VP of Sales at these companies"
* "Find engineering leaders at these 10 startups"

### How titles work

Canvas translates your intent into specific LinkedIn-style job titles:

| You say               | Canvas searches for                                        |
| --------------------- | ---------------------------------------------------------- |
| "founders"            | CEO, Founder, Co-Founder                                   |
| "sales leaders"       | CRO, VP of Sales, Head of Sales, Sales Director            |
| "engineering leaders" | CTO, VP of Engineering, Director of Engineering            |
| "product leaders"     | CPO, VP of Product, Head of Product                        |
| "ML engineers"        | ML Engineer, Machine Learning Engineer, Senior ML Engineer |

### Seniority levels

Every people search requires a seniority level to avoid overly broad queries:

| Level                      | Matches titles like                |
| -------------------------- | ---------------------------------- |
| c-suite                    | CEO, CTO, CFO, COO, CMO            |
| vp / svp                   | VP of X, SVP of X                  |
| director / head            | Director of X, Head of X           |
| manager                    | Engineering Manager, Sales Manager |
| lead                       | Tech Lead, Team Lead               |
| senior / staff / principal | Senior Engineer, Staff Engineer    |

***

## Natural language search

Best when you want to describe who you're looking for without having specific companies.

### Example prompts

* "Find senior ML engineers at Series B fintech companies in SF"
* "Find product managers who previously worked at Google"
* "Find CTOs at healthcare startups with 50+ employees"

***

## List all people

Returns everyone at a company without role filters. Use when you want a full org chart.

### Example prompts

* "List all people at Artisan"
* "Show me everyone at this company"

***

## What you get back

| Field         | Description                       |
| ------------- | --------------------------------- |
| name          | Full name                         |
| first\_name   | First name                        |
| last\_name    | Last name                         |
| title         | Job title                         |
| company       | Company name                      |
| linkedin\_url | LinkedIn profile URL              |
| email         | Email (sometimes, not guaranteed) |
| phone         | Phone (sometimes, not guaranteed) |

<Note>
  People search doesn't always return emails. Chain to contact enrichment for verified email addresses.
</Note>