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

# Person Find

> Find people by title, company, location and other filters, with optional quoted phone lookup.

Search for people matching `job_titles`, `keywords`, `companies`, `company_domains`, `location`, `skills`, `seniority`, `industry`, or `company_size`.

<ParamField body="limit" type="integer" default="100">
  Requested number of people, from 1 to 500. Phone pricing uses this limit even if fewer people match.
</ParamField>

<ParamField body="offset" type="integer" default="0">
  Zero-based row offset for pagination.
</ParamField>

<ParamField body="include_phone" type="boolean" default="false">
  Buy phone lookups for up to the requested limit at the per-person add-on listed on the [Pricing](/pricing) page, with no guarantee of a hit.
</ParamField>

<Snippet file="phone-lookup.mdx" />

<Snippet file="audit-context-params.mdx" />

```typescript theme={null}
const people = await agent.personFind({
  job_titles: ['CTO'], limit: 3, includePhone: true,
  maxCost: 1, waitForPhones: true,
}); // The phone add-on plus the base price must fit maxCost.
```

```python theme={null}
people = client.person_find(
    job_titles=["CTO"], limit=3, include_phone=True,
    max_cost=1, wait_for_phones=True,
)
# Async: await client.aperson_find(...) with the same arguments.
```

The paid retry returns `202` with `request_id`, `receipt_id`, and `status: "processing"`. The SDK waits for the result by default; `wait: false` / `wait=False` returns the accepted job and receipt IDs instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.