People API

🚀
Use the People API to find detailed information on the people you are interested in. See their key positions, directorships and shareholdings as well as their contact information

Key details

Use your Beauhurst API Key to authenticate your requests
Use a Collection ID or a list of People IDs to get detailed people information
Include the values that are important such as their directorships and shareholdings
Use the modified_since parameter to automatically get updates on any changes

Parameters

sort string

Which field to use when ordering the results

limit integer

Number of results to return per page

offset integer

The initial index from which to return the results

includes array

Include the following in the response

id
Beauhurst URL
Basic details
Contact information
Current shareholdings
Directorships
Secretary positions
Company positions
Fund positions

collection_id string

Use a Collection ID to return the people in the collection created

person_ids array

List of Beauhurst People IDs for the people you want data for

email array

List of email addresses to search for the people you want data for

modified_since string

Return data updated since the date and time entered (YYYY-MM-DD hh:mm:ss)

The People object

id string

Beauhurst unique identifier for the person

beauhurst_url string

Beauhurst URL for the person

basic_details object

The basic details of the person

Field name	Data type	Description
`name`	string	Full name
`date_of_birth`	string	Date of birth in YYYY-MM format
`age`	string	Current age of the person
`gender`	string	Gender of the person
`nationality`	array of strings	List of nationalities
`country_of_residence`	array of strings	List of countries of residence

contact_information object

Contact information for the person

Field name	Data type	Description
`email_addresses`	array of strings	List of email addresses
`linkedin_url`	string	LinkedIn URL

current_shareholdings array of objects

List of current shareholdings of the person

Field name	Data type	Description
`company_id`	string	Unique Beauhurst ID for the company
`company_name`	string	Company name
`share_class`	string	Share class
`percentage_owned`	number	Percentage owned
`estimated_value`	integer	Estimated value of shareholdings

directorships array of objects

List of directorships

Field name	Data type	Description
`company_id`	string	Unique Beauhurst ID for the company
`company_name`	string	Company name
`email`	string	Director email
`from_date`	string	Directorship start date YYYY-MM-DD
`until_date`	string	Directorship end date YYYY-MM-DD

secretary_positions array of objects

List of secretary positions

Field name	Data type	Description
`company_id`	string	Unique Beauhurst ID for the company
`company_name`	string	Company name
`email`	string	Secretary email
`from_date`	string	Position start date YYYY-MM-DD
`until_date`	string	Position end date YYYY-MM-DD

company_positions array of objects

List of company positions

Field name	Data type	Description
`company_id`	string	Unique Beauhurst ID for the company
`company_name`	string	Company name
`title`	string	Title of position
`job_functions`	array of strings	List of job functions
`is_founder`	boolean	If they are a founder of the company
`email`	string	Company email
`from_date`	string	Position start date YYYY-MM-DD
`until_date`	string	Position end date YYYY-MM-DD

fund_positions array of objects

List of fund positions

Field name	Data type	Description
`fund_id`	string	Unique Beauhurst ID for the fund
`fund_name`	string	Fund name
`title`	string	Title of position
`email`	string	Fund email
`currently_active`	boolean	If this person is currently at the fund