Skip to main content
GET
Get a person by UUID.

Authorizations

x-api-key
string
header
required

Path Parameters

person_uuid
string
required

Response

200 - application/json

Person response schema.

company_name
string | null
required
email
string | null
required
job_title
string | null
required
last_activity_date
string | null
required
linkedin_url
string | null
required
name
string | null
required
uuid
string
required
city
string | null
company_pathpower
PathPowerMetrics · object | null
country
string | null
current_company
CurrentCompany · object | null
current_company_domain
string | null

Domain of the company on the person's current employment row. Filterable via ?current_company_domain=.

current_company_name
string | null

Name of the company on the person's current (is_current) employment row. Filterable via ?current_company_name=.

current_job_title
string | null

Current job title from the LiveData-enriched employment history ledger. Filterable via ?current_job_title=.

description
string | null
email_3
string | null
email_3_last_seen
string | null
email_4
string | null
email_4_last_seen
string | null
email_5
string | null
email_5_last_seen
string | null
email_last_seen
string | null
entity_lists
EntityListMembership · object[] | null
facebook_url
string | null
investor_types
string[] | null
job_changed_at
string | null

ISO 8601 timestamp of when the person moved into their current role (started_at of the is_current row). Filterable via ?job_changed_since / ?job_changed_before.

last_activity
string | null
last_contact_at
string | null

Most recent tenant-wide contact timestamp, aggregated across all activity types. Alias of last_activity_date; both fields read from the same ActivityDateByEntity column that powers the list/detail endpoints.

logo_url
string | null
my_next_meeting_at
string | null

ISO 8601 timestamp of the earliest future calendar event involving this person where the calling user (x-rings-user-id) is a participant. null when no user context is provided.

my_next_meeting_title
string | null

Title of the per-user next meeting. null when no user context is provided.

next_meeting_at
string | null

ISO 8601 timestamp of the earliest future calendar event involving this person (tenant-wide). Source: Activity.kind=EVENT, start_date >= now(), non-cancelled, non-deleted, non-hidden. Listener-driven with hourly recompute fallback.

next_meeting_title
string | null

Title of the tenant-wide next meeting.

next_meeting_with_user_uuid
string | null

UsersPrivate.uuid of the internal user attending the tenant-wide next meeting (prefers organizer).

pathpower
PathPowerMetrics · object | null
phone_numbers
string[] | null
previous_job_ended_at
string | null

ISO 8601 timestamp of the most-recent prior job's end date (ended_at of the most-recent non-current row). Filterable via ?previous_job_ended_since / ?previous_job_ended_before.

priority_management
PriorityManagement · object | null
secondary_email
string | null
secondary_email_last_seen
string | null
state
string | null
strongest_relationships
StrongestRelationship · object[] | null

Up to two tenant internal users with the strongest relationship to this person, ranked by priority_management.rq_pretty (desc). Precomputed every ~3 hours; null when no qualifying signals exist.

twitter_url
string | null