Find key information on key people
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_sinceparameter 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 |