Person object

The person object is present in most responses (/enrich, /search) and represents a person (lead) and contains it’s potential email address, mobile number, and many more datapoints.

Any property can be null if no data is available. High-level properties (such as location) can also be null, hence accessing nested keys needs to be done carefully (null-check).

The person object will be returned along with its company. You can find the details of every company fields here.

When performing a Search Person API request, the mobile and email wont be present in the response. Use our Enrich person endpoint to reveal/access those.

Property	Type	Description
`person_id`	string	Unique identifier for the person in Prospeo’s system.
`first_name`	string	Person’s given name.
`last_name`	string	Person’s family name.
`full_name`	string	Person’s full name.
`linkedin_url`	string	Link to the person’s public LinkedIn profile.
`headline`	string	Person’s headline summarizing current role and expertise.
`current_job_title`	string	Title of the person’s current position.
`current_job_key`	string	Internal key representing the current job in Prospeo’s system. As a person can have multiple current jobs, this key represents the main job.
`linkedin_member_id`	string	Unique numeric identifier assigned by LinkedIn to the member.
`skills`	array of strings	List of the person’s self-assigned skills (can be any string).
`last_job_change_detected_at`	datetime	When was the last job change of that person detected by Prospeo.
Job Details (within `job_history` array)
`title`	string	Job title for this role.
`company_name`	string	Name of the company.
`current`	boolean	`true` if this role is current (no end date); otherwise `false`. Multiple job can be `current` at once.
`start_year`	integer	Four-digit year when this role began.
`start_month`	integer	Month (1–12) when this role began. This can be `null` if unspecified.
`end_year`	integer	Four-digit year when this role ended, or `null` if ongoing.
`end_month`	integer	Month (1–12) when this role ended, or `null` if ongoing.
`duration_in_months`	integer	Total duration of the role in months.
`departments`	array of strings	Departments assigned to this job. See our list of departments here.
`seniority`	string	Seniority assigned to this job. See our list of seniorities here.
`company_id`	string	Prospeo’s internal identifier for the company. This can be `null` if the job is not internally linked to a company.
`job_key`	string	Prospeo’s internal key for the specific job entry. Useful when multiple `current` jobs exists to find the correct one with `current_job_key`.
Mobile Details (within `mobile`)
`status`	string	Verification status (`VERIFIED` or `UNAVAILABLE`).
`revealed`	boolean	`true` if you revealed and paid for this mobile; `false` otherwise.
`mobile`	string	E.164 formatted phone number (e.g., `"+12345678900"`). Only available if the mobile is `revealed`.
`mobile_national`	string	National format of the number (e.g., `"234 567 8900"`). Only available if the mobile is `revealed`.
`mobile_international`	string	International formatting of the number (e.g., `"+1 234 567 8900"`). Only available if the mobile is `revealed`.
`mobile_country_code`	string	ISO 3166-1 alpha-2 country code for the number. Only available if the mobile is `revealed`.
`mobile_country`	string	Full country name corresponding to `mobile_country`. Only available if the mobile is `revealed`.
Email Details (within `email`)
`status`	string	Verification status (`VERIFIED` or `UNAVAILABLE`).
`revealed`	boolean	`true` if the email is revealed; `false` otherwise.
`email`	string	The person’s email address. Only available if the email is `revealed`.
`email_mx_provider`	string	MX record provider for the domain (e.g., `"GOOGLE"`). Only available if the email is `revealed`.
`email_catch_all_domain`	boolean	`true` if the domain accepts all emails (catch-all); `false` otherwise. Only available if the email is `revealed`.
Location Details (within `location`)
`country`	string	Full country name (e.g., `"United States"`).
`country_code`	string	ISO 3166-1 alpha-2 country code (e.g., `"US"`).
`state`	string	State or region name.
`city`	string	City name.
`time_zone`	string	IANA timezone identifier (e.g., `"America/Los_Angeles"`).
`time_zone_offset`	integer	UTC offset in hours (e.g., `-8`).

JSON example


"person": {
    "person_id": "681d3b5efb651de6f7ffdecb",
    "first_name": "Roger",
    "last_name": "Sterling",
    "full_name": "Roger Sterling",
    "linkedin_url": "https://www.linkedin.com/in/roger-sterling",
    "current_job_title": "Head of Ads",
    "current_job_key": "66d9e67b86199f0001b24246",
    "headline": "Head of Ads @ Prospeo.io | GTM pro",
    "linkedin_member_id": "161379400",
    "last_job_change_detected_at": "2024-08-27T21:18:29.577Z",
    "job_history": [
        {
            "title": "Head of Ads",
            "company_name": "Prospeo.io",
            "current": true,
            "start_year": 2024,
            "start_month": 12,
            "end_year": null,
            "end_month": null,
            "duration_in_months": 10,
            "departments": [
                "Online marketing",
                "Communication"
            ],
            "seniority": "Head",
            "company_id": "63f53afe4ceeca00016bdd2f",
            "job_key": "66d9e67b86199f0001b24246"
        },
        {
            "title": "Managing Partner",
            "company_name": "Sterling-Cooper",
            "current": false,
            "start_year": 2014,
            "start_month": 7,
            "end_year": 2024,
            "end_month": 7,
            "duration_in_months": 120,
            "departments": [
                "Advertising"
            ],
            "seniority": "Partner",
            "company_id": "50f53afe4ceeca00016bdd2f",
            "job_key": "60d9e67b16199f1001b24246"
        }
    ],
    "mobile": {
        "status": "VERIFIED",
        "revealed": true,
        "mobile": "+1 234 567 8900",
        "mobile_national": "234 567 8900",
        "mobile_international": "+12345678900",
        "mobile_country": "United States",
        "mobile_country_code": "US"
    },
    "email": {
        "status": "VERIFIED",
        "revealed": true,
        "email": "roger@prospeo.io",
        "email_mx_provider": "GOOGLE",
        "email_catch_all_domain": false
    },
    "location": {
        "country": "United States",
        "country_code": "US",
        "state": "California",
        "city": "Los Angeles",
        "time_zone": "America/Los_Angeles",
        "time_zone_offset": -8
    },
    "skills": [
        "Google Ads",
        "Paid media",
        "Marketing"
    ]
}