---
title: "People at one company"
method: GET
path: "/api/v1/companies/{domain}/people"
tags: ["Companies"]
---

# People at one company

`GET /api/v1/companies/{domain}/people`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/companies/{domain}/people`
- Auth: HTTP bearer

How many people Argorant has at one company, how many of them have a work email on record, the company's profile, and a short preview of the people. Free. To go through all of them, use GET /api/v1/people/search with company_domain.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts`, `argorant:search_segments` |

## Path parameters

- `domain` string, required

## Query parameters

- `title` string
- `seniority` 'Owner' | 'Founder' | 'Partner' | 'C-Level' | 'VP' | 'Director' | 'Manager' | 'Senior' | 'Entry' | 'Intern'
- `departments` string
- `country` string
- `limit` integer

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `company_domain` string
  - `company` object
    - `company` string
    - `company_domain` string
    - `industry` string
    - `employee_range` string
    - `country` string
  - `people_count` integer
  - `with_work_email` integer
  - `people` object[]
    - `record_id` string
    - `preview` string
    - `title` string
    - `seniority` string
    - `departments` string[]
    - `company` string
    - `company_normalized` string
    - `company_domain` string
    - `city` string
    - `state` string, nullable
    - `country` string
    - `industry` string
    - `industries` string[]
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `next_cursor` string, nullable
  - `has_more` boolean
  - `more` string

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts or argorant:search_segments.
- `404`: 404 Not found. `not_found` when the item does not exist in your workspace.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)