---
updatedAt: 2026-06-23T14:54:34.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# Get the summary of a Person
Get the summary of a single person including the basic details, current shareholdings, directorships, secretary positions, company and fund positions.
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Beauhurst API v2",
"version": "1.0.0 (externalapi)",
"description": "Usage
The API only accepts GET requests over HTTPS.
Authorization
The Beauhurst API requires authentication in the form of an API key,provided in the format 'apikey '.
To obtain an API key, please contact your subscription's account manager at Beauhurst. Be sure to keep this key private and secure.
"
},
"paths": {
"/person/{person_id}/summary": {
"get": {
"operationId": "person_summary_retrieve",
"description": "Get the summary of a single person including the basic details, current shareholdings, directorships, secretary positions, company and fund positions.",
"summary": "Get the summary of a Person",
"parameters": [
{
"in": "path",
"name": "person_id",
"schema": {
"type": "string"
},
"description": "Beauhurst Person ID",
"required": true
}
],
"tags": [
"person"
],
"security": [
{
"tokenAuth": []
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PersonSummary"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"PersonBasicDetails": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"date_of_birth": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$",
"example": "1990-07",
"readOnly": true,
"nullable": true,
"description": "Date of birth in YYYY-MM format"
},
"age": {
"type": "integer",
"nullable": true
},
"gender": {
"type": "string"
},
"nationality": {
"type": "array",
"items": {
"type": "string"
}
},
"country_of_residence": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true
}
},
"required": [
"age",
"country_of_residence",
"date_of_birth",
"gender",
"name",
"nationality"
]
},
"PersonCompanyPosition": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"nullable": true
},
"company_name": {
"type": "string",
"nullable": true,
"description": "True Company name"
},
"title": {
"type": "string",
"readOnly": true
},
"job_functions": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true
},
"company_registration_number": {
"type": "string",
"nullable": true,
"description": "Company registration number"
},
"corporate_register_country": {
"type": "string",
"nullable": true,
"description": "Lowercase ISO 3166-1 alpha-2 code of the corporate registry's country"
},
"is_founder": {
"type": "boolean",
"readOnly": true,
"description": "Was this person a founder?"
},
"email": {
"type": "string",
"nullable": true
},
"until_date": {
"type": "string",
"format": "date",
"nullable": true
}
},
"required": [
"company_name",
"company_registration_number",
"corporate_register_country",
"email",
"is_founder",
"job_functions",
"title",
"true_company_id",
"until_date"
]
},
"PersonContactInformation": {
"type": "object",
"properties": {
"email_addresses": {
"type": "array",
"items": {
"type": "string"
}
},
"linkedin_url": {
"type": "string",
"format": "uri",
"nullable": true
}
},
"required": [
"email_addresses",
"linkedin_url"
]
},
"PersonDirectorship": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"nullable": true
},
"company_name": {
"type": "string",
"nullable": true,
"description": "Registered name of the legal entity"
},
"company_registration_number": {
"type": "string",
"nullable": true,
"description": "Company registration number"
},
"corporate_register_country": {
"type": "string",
"nullable": true,
"description": "Lowercase ISO 3166-1 alpha-2 code of the corporate registry's country"
},
"email": {
"type": "string",
"nullable": true
},
"from_date": {
"type": "string",
"format": "date",
"nullable": true
},
"until_date": {
"type": "string",
"format": "date",
"nullable": true
}
},
"required": [
"company_name",
"company_registration_number",
"corporate_register_country",
"email",
"from_date",
"true_company_id",
"until_date"
]
},
"PersonFundPosition": {
"type": "object",
"properties": {
"fund_id": {
"type": "string",
"nullable": true
},
"fund_name": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"readOnly": true
},
"email": {
"type": "string",
"nullable": true
},
"is_active": {
"type": "boolean"
}
},
"required": [
"email",
"fund_id",
"fund_name",
"is_active",
"title"
]
},
"PersonSecretaryPosition": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"nullable": true
},
"company_name": {
"type": "string",
"nullable": true,
"description": "Registered name of the legal entity"
},
"company_registration_number": {
"type": "string",
"nullable": true,
"description": "Company registration number"
},
"corporate_register_country": {
"type": "string",
"nullable": true,
"description": "Lowercase ISO 3166-1 alpha-2 code of the corporate registry's country"
},
"email": {
"type": "string",
"nullable": true
},
"from_date": {
"type": "string",
"format": "date",
"nullable": true
},
"until_date": {
"type": "string",
"format": "date",
"nullable": true
}
},
"required": [
"company_name",
"company_registration_number",
"corporate_register_country",
"email",
"from_date",
"true_company_id",
"until_date"
]
},
"PersonShareholding": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"nullable": true
},
"company_name": {
"type": "string",
"nullable": true,
"description": "Registered name of the legal entity"
},
"company_registration_number": {
"type": "string",
"nullable": true,
"description": "Company registration number"
},
"corporate_register_country": {
"type": "string",
"nullable": true,
"description": "Lowercase ISO 3166-1 alpha-2 code of the corporate registry's country"
},
"share_class": {
"type": "string",
"readOnly": true
},
"percentage_owned": {
"type": "number",
"format": "double"
},
"estimated_value": {
"type": "integer",
"nullable": true
},
"estimated_value_currency": {
"type": "string",
"nullable": true
}
},
"required": [
"company_name",
"company_registration_number",
"corporate_register_country",
"estimated_value",
"estimated_value_currency",
"percentage_owned",
"share_class",
"true_company_id"
]
},
"PersonSummary": {
"type": "object",
"properties": {
"person_id": {
"type": "string"
},
"beauhurst_url": {
"type": "string",
"readOnly": true
},
"basic_details": {
"$ref": "#/components/schemas/PersonBasicDetails"
},
"contact_information": {
"$ref": "#/components/schemas/PersonContactInformation"
},
"current_shareholdings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PersonShareholding"
}
},
"directorships": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PersonDirectorship"
}
},
"secretary_positions": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PersonSecretaryPosition"
}
},
"company_positions": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PersonCompanyPosition"
}
},
"fund_positions": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PersonFundPosition"
}
}
},
"required": [
"basic_details",
"beauhurst_url",
"company_positions",
"contact_information",
"current_shareholdings",
"directorships",
"fund_positions",
"person_id",
"secretary_positions"
]
}
},
"securitySchemes": {
"tokenAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "Token-based authentication with required prefix \"APIkey\""
}
}
},
"servers": [
{
"url": "https://platform.beauhurst.com/_api/v2.0"
}
],
"x-readme": {}
}
```