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 the person currently works at. Filterable via ?current_company_domain=.

current_company_name
string | null

Name of the company the person currently works at. Filterable via ?current_company_name=.

current_job_title
string | null

Current job title, from the person's enriched employment history. Filterable via ?current_job_title=.

custom_fields
Custom Fields · object | null

The tenant's person custom field values, keyed by field id from GET /v1/persons/custom-fields. Numbers are JSON numbers, dates are 'YYYY-MM-DD' strings, single selections are the option text, multi selections are a list of option texts. Fields without a value are omitted.

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
employment_history
PersonEmploymentEntry · object[] | null

Every job on the person's enriched employment history, most recent first. Only returned by GET /v1/persons/{person_uuid}; null on list and lookup responses. An empty list means no history has been enriched for this person.

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. 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 always hold the same value.

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. Cancelled and deleted events are excluded. Updates as calendar changes arrive, with an hourly reconciliation pass.

next_meeting_title
string | null

Title of the tenant-wide next meeting.

next_meeting_with_user_uuid
string | null

UUID of the internal ring member attending the tenant-wide next meeting (prefers the organizer).

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

ISO 8601 timestamp of when the person's most recent previous job ended. 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). Refreshed about every 3 hours; null when no qualifying signals exist.

twitter_url
string | null