---
title: "Get Person By Id Or Urn"
method: GET
path: "/persons/{id_or_urn}"
tags: ["persons"]
---

# Get Person By Id Or Urn

`GET /persons/{id_or_urn}`

## Path parameters

- `id_or_urn` union, required
  - integer
  - string, uuid
  - string

## Query parameters

- `company_context_urns` string[]

## Response `200`

Successful Response

- PersonOutput
  - `full_name` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `profile_picture_url` string, nullable
  - `contact` object, nullable
    - `emails` string[]
    - `phone_numbers` string[]
    - `exec_emails` string[]
    - `primary_email` string, nullable
    - `primary_email_person_id` integer, nullable
  - `location` object, nullable
    - `address_formatted` string, nullable
    - `location` string, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
    - `country` string, nullable
    - `metro_areas` string[], nullable
  - `education` EducationMetadataOutput[]
    - `school` union, required
      - SchoolOutput
        - `name` string, nullable
        - `linkedin_url` string, nullable
        - `logo_url` string, nullable
        - `entity_urn` string, required
      - SchoolInput
        - `name` string, nullable
        - `linkedin_url` string, nullable
        - `logo_url` string, nullable
      - string
    - `degree` string, nullable
    - `standardized_degree` 'PHD' | 'DOCTOR_OF_MEDICINE' | 'JURIS_DOCTOR' | 'OTHER_DOCTORATE' | 'MASTER_OF_BUSINESS_ADMINISTRATION' | 'MASTERS_DEGREE' | 'BACHELORS_DEGREE' | 'ASSOCIATES_DEGREE' | 'CERTIFICATE' | 'HIGH_SCHOOL' | 'OTHER' | 'UNKNOWN'
    - `field` string, nullable
    - `grade` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
  - `socials` object, nullable
  - `experience` ExperienceMetadataOutput[]
    - `contact` ContactMetadata
      - `emails` string[]
      - `phone_numbers` string[]
      - `exec_emails` string[]
      - `primary_email` string, nullable
      - `primary_email_person_id` integer, nullable
    - `title` string, nullable
    - `department` 'Advisor' | 'Customer Success' | 'Data' | 'Design' | 'Engineering' | 'Finance' | 'Legal' | 'Marketing' | 'Operations' | 'Other' | 'People' | 'Product' | 'Sales' | 'Support'
    - `description` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `is_current_position` boolean, nullable
    - `location` string, nullable
    - `role_type` 'FOUNDER' | 'CEO' | 'EXECUTIVE' | 'OPERATOR' | 'INTERN' | 'ALUMNI' | 'ADVISER' | 'EMPLOYEE' | 'INVESTOR' | 'FALSE_POSITION'
    - `company` string, required
    - `company_name` string, nullable
  - `unstandardized_experience__internal` UnstandardizedExperienceMetadataOutput[]
    - `contact` ContactMetadata
      - `emails` string[]
      - `phone_numbers` string[]
      - `exec_emails` string[]
      - `primary_email` string, nullable
      - `primary_email_person_id` integer, nullable
    - `title` string, nullable
    - `department` 'Advisor' | 'Customer Success' | 'Data' | 'Design' | 'Engineering' | 'Finance' | 'Legal' | 'Marketing' | 'Operations' | 'Other' | 'People' | 'Product' | 'Sales' | 'Support'
    - `description` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `is_current_position` boolean, nullable
    - `location` string, nullable
    - `role_type` 'FOUNDER' | 'CEO' | 'EXECUTIVE' | 'OPERATOR' | 'INTERN' | 'ALUMNI' | 'ADVISER' | 'EMPLOYEE' | 'INVESTOR' | 'FALSE_POSITION'
    - `company` union, required
      - string
      - string
  - `websites` WebsiteMetadata[]
    - `url` string, nullable
    - `domain` string, nullable
    - `is_broken` boolean, nullable
  - `linkedin_connections` integer, nullable
  - `usurping_person_id` integer, nullable
  - `linkedin_headline` string, nullable
  - `linkedin_profile_visibility_type` 'FULLY_PUBLIC' | 'EXPERIENCE_AND_EDUCATION_BLURRED' | 'EXPERIENCES_AND_EDUCATION_SECTIONS_HIDDEN' | 'PRIVATE_OR_NONEXISTENT', nullable
  - `last_checked_at` string, nullable
  - `languages` LanguageMetadata[]
    - `name` string, required
    - `proficiency` string, nullable
  - `requested_entity_urn` string, nullable
  - `entity_urn` string, required
  - `id` union, required
    - string, uuid
    - integer
  - `highlights` ServicesMidtierSchemasPersonHighlightOutput[]
    - `category` 'Seasoned Executive' | 'Seasoned Operator' | 'Seasoned Founder' | 'Seasoned Adviser' | 'Unicorn Executive' | 'Unicorn Operator' | 'Unicorn Founder' | 'Unicorn Adviser' | 'High Growth Startup Executive' | 'High Growth Startup Operator' | 'High Growth Startup Founder' | 'High Growth Startup Adviser' | 'Prior VC Backed Executive' | 'Prior VC Backed Operator' | 'Prior VC Backed Founder' | 'Prior VC Backed Adviser' | 'Current Student' | 'Top University' | 'HBCU Alum' | 'HBCU University' | 'Deep Technical Background' | 'Prior Exit' | 'Top Company Alum' | 'Unicorn Alum' | 'Major Tech Company Experience' | 'Legacy Tech Company Experience' | 'Elite Industry Experience' | 'Major Research Institution Experience' | 'Major Government Experience' | 'Major Financial Institution Experience' | 'Venture Background' | '$5M Club' | '$10M Club' | '$15M Club' | '$20M Club' | '$25M Club' | '$30M Club' | '$30M Raised' | '$35M Club' | '$40M Club' | '$45M Club' | '$50M Club' | '$50M+ Club' | '$55M Club' | '$60M Club' | '$65M Club' | '$70M Club' | '$75M Club' | '$80M Club' | '$85M Club' | '$90M Club' | '$95M Club' | '$100M Club' | '$105M Club' | '$110M Club' | '$115M Club' | '$120M Club' | '$125M Club' | '$130M Club' | '$135M Club' | '$140M Club' | '$145M Club' | '$150M Club' | '$155M Club' | '$160M Club' | '$165M Club' | '$170M Club' | '$175M Club' | '$180M Club' | '$185M Club' | '$190M Club' | '$195M Club' | '$200M Club' | '$205M Club' | '$210M Club' | '$215M Club' | '$220M Club' | '$225M Club' | '$230M Club' | '$235M Club' | '$240M Club' | '$245M Club' | '$250M Club' | '$255M Club' | '$260M Club' | '$265M Club' | '$270M Club' | '$275M Club' | '$280M Club' | '$285M Club' | '$290M Club' | '$295M Club' | '$300M Club' | 'Free Agent' | 'Founder Turned Operator' | 'Stealth Founder' | 'Vested Former Founder' | 'Jack of All Trades' | 'YC Backed Founder' | 'Top Web3 Experience' | 'Top AI Experience' | 'Notable Followers' | 'New Notable Followers', required
    - `date_added` string, nullable
    - `text` string, nullable
    - `company_urn` string, nullable
  - `notable_followers` NotableFollowerOutput[]
    - `follower_urn` union, required
      - string
      - string
    - `follower_name` string, nullable
    - `firm_urn` string, nullable
    - `firm_name` string, nullable
    - `followed_urn` union, required
      - string
      - string
    - `followed_name` string, nullable
    - `follow_observed_at` string, nullable
  - `num_notable_followers` integer, nullable
  - `updated_at` string, nullable
  - `awards__beta` string[]
  - `recommendations__beta` string[]
  - `current_company_urns` string[]
  - `last_refreshed_at` string, nullable
  - `investor_urn` string, nullable
  - `is_redacted` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/versions/83a88f0a9b1c/schema)