---
title: "List people"
method: GET
path: "/people"
tags: ["People"]
---

# List people

`GET /people`

## Request

- Base URL: `https://www.happyscribe.com/api/v1`
- URL: `https://www.happyscribe.com/api/v1/people`
- Auth: API key in header `Authorization`

Returns a paginated list of people discovered in your workspace's meeting
transcripts, sorted by name ascending.

<Note>The Memory API is in private beta. Requests from non-enrolled workspaces return a 404.</Note>

## Query parameters

- `workspace_id` string, required
- `search` string
- `email` string
- `company_id` integer
- `page` integer
- `per_page` integer

## Response `200`

A paginated list of people.

- object
  - `results` Person[]: The people on this page.
    - `id` integer: Unique identifier.
    - `name` string: Display name (typically first name + last initial, or first name alone).
    - `full_name` string: Full name when available.
    - `emails` string[]: All email addresses recorded for this person, in discovery order.
    - `primary_email` string: The first email address recorded for this person. Discovery order, not user preference.
    - `company` Company
      - `id` integer: Unique identifier.
      - `name` string: The company name.
      - `primary_domain` string: The primary web domain for the company.
      - `domains` string[]: All known domains, including `primary_domain`.
      - `industry` string, nullable: Industry classification from enrichment.
      - `employee_count` integer, nullable: Approximate number of employees from enrichment.
      - `founded_year` integer, nullable: Year founded.
      - `short_description` string, nullable: A one-line description.
      - `keywords` string[]: Keywords describing the company.
      - `city` string, nullable: Headquarters city.
      - `country` string, nullable: Headquarters country.
      - `website_url` string, nullable: The company website.
      - `linkedin_url` string, nullable: The company LinkedIn page.
      - `logo_url` string, nullable: The company logo.
      - `total_funding` number, nullable: Total funding raised in USD. May be `null` even when enrichment has run.
      - `annual_revenue` number, nullable: Estimated annual revenue in USD. May be `null` even when enrichment has run.
      - `latest_funding_stage` string, nullable: Most recent funding stage, e.g. `Series A`. May be `null` even when enrichment has run.
      - `created_at` string, date-time: When it was created, in ISO 8601.
      - `updated_at` string, date-time: When it last changed, in ISO 8601.
      - `_links` object: Links to related resources.
        - `self` object: This resource.
          - `url` string: The URL.
    - `job_title` string, nullable: From enrichment. Person enrichment is disabled by default — typically `null`.
    - `seniority` string, nullable: From enrichment. Typically `null` unless person enrichment is enabled.
    - `headline` string, nullable: From enrichment. Typically `null` unless person enrichment is enabled.
    - `linkedin_url` string, nullable: From enrichment. Typically `null` unless person enrichment is enabled.
    - `city` string, nullable: From enrichment. Typically `null` unless person enrichment is enabled.
    - `country` string, nullable: From enrichment. Typically `null` unless person enrichment is enabled.
    - `photo_url` string, nullable: Full-size photo URL.
    - `avatar_url` string, nullable: Thumbnail avatar URL.
    - `enriched_at` string, date-time, nullable: Timestamp of the last enrichment run, or `null` if enrichment has not run.
    - `created_at` string, date-time: When it was created, in ISO 8601.
    - `updated_at` string, date-time: When it last changed, in ISO 8601.
    - `_links` object: Links to related resources.
      - `self` object: This resource.
        - `url` string: The URL.
  - `_links` PaginationLinks: Pagination links. `next` is omitted on the last page.
    - `next` object: The next page, with the same filters. Absent on the last page.
      - `url` string: URL of the next page.

## Other responses

- `400`: Missing or invalid `workspace_id`, or `company_id` is not an integer.
- `401`: Your API key is missing (`missing_api_key`) or wrong (`invalid_api_key`), or it may not access this resource (`unauthorized`).
- `404`: Workspace is not enrolled in the Memory API.

---

[API](https://skmtc.dev/happyscribe/apis/happyscribe-api.md) - [All operations](https://skmtc.dev/happyscribe/apis/happyscribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happyscribe/apis/happyscribe-api/revisions/1281bd968c3d?raw)