---
title: "Retrieve a person"
method: GET
path: "/people/{id}"
tags: ["People"]
---

# Retrieve a person

`GET /people/{id}`

## Request

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

Returns a single person by ID.

## Path parameters

- `id` integer, required

## Response `200`

The person.

- Person
  - `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.

## Other responses

- `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, person not found, or person belongs to another workspace.

---

[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)