---
updatedAt: 2026-05-05T12:51:04.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# List True Company's Key People
Get key people for a company using a Beauhurst True Company ID;
supports filtering by whether the person is currently active and ordering by name.
# 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": {
"/truecompany/{true_company_id}/keypeople": {
"get": {
"operationId": "truecompany_keypeople_list",
"description": "\n Get key people for a company using a Beauhurst True Company ID;\n supports filtering by whether the person is currently active and ordering by name.\n ",
"summary": "List True Company's Key People",
"parameters": [
{
"in": "query",
"name": "is_active",
"schema": {
"type": "boolean",
"nullable": true
},
"description": "Return only currently active key people when true, or only inactive key people when false"
},
{
"in": "query",
"name": "is_founder",
"schema": {
"type": "boolean",
"nullable": true
},
"description": "Return only company founders when true, or only non-founders when false"
},
{
"in": "query",
"name": "job_function",
"schema": {
"enum": [
"Arts & design",
"Board",
"Client services",
"Construction & demolition",
"Consultancy & research",
"Data",
"Education",
"Engineering",
"Events",
"Finance",
"Health, safety & environment",
"Human resources & people",
"Information technology",
"Investment",
"Legal",
"Logistics",
"Marketing",
"Media",
"Medical & clinical",
"Operations",
"Procurement",
"Product/UX",
"Projects",
"Property",
"Quality assurance",
"Retail",
"Risk",
"Sales/BD",
"Science",
"Software development",
"Strategy",
"Technology"
],
"type": "string",
"minLength": 1
},
"description": "Return only key people whose job functions include this value\n\n* `Arts & design` - Arts & design\n* `Board` - Board\n* `Client services` - Client services\n* `Construction & demolition` - Construction & demolition\n* `Consultancy & research` - Consultancy & research\n* `Data` - Data\n* `Education` - Education\n* `Engineering` - Engineering\n* `Events` - Events\n* `Finance` - Finance\n* `Health, safety & environment` - Health, safety & environment\n* `Human resources & people` - Human resources & people\n* `Information technology` - Information technology\n* `Investment` - Investment\n* `Legal` - Legal\n* `Logistics` - Logistics\n* `Marketing` - Marketing\n* `Media` - Media\n* `Medical & clinical` - Medical & clinical\n* `Operations` - Operations\n* `Procurement` - Procurement\n* `Product/UX` - Product/UX\n* `Projects` - Projects\n* `Property` - Property\n* `Quality assurance` - Quality assurance\n* `Retail` - Retail\n* `Risk` - Risk\n* `Sales/BD` - Sales/BD\n* `Science` - Science\n* `Software development` - Software development\n* `Strategy` - Strategy\n* `Technology` - Technology"
},
{
"name": "limit",
"required": false,
"in": "query",
"description": "Number of results to return per page.",
"schema": {
"type": "integer"
}
},
{
"name": "offset",
"required": false,
"in": "query",
"description": "The initial index from which to return the results.",
"schema": {
"type": "integer"
}
},
{
"name": "sort",
"required": false,
"in": "query",
"description": "Sort by name. Prefix with '-' for descending order.\n\n* `name` - name\n* `-name` - -name",
"schema": {
"type": "string",
"enum": [
"name",
"-name"
],
"minLength": 1
}
},
{
"in": "path",
"name": "true_company_id",
"schema": {
"type": "string"
},
"description": "Beauhurst True Company ID",
"required": true
}
],
"tags": [
"truecompany"
],
"security": [
{
"tokenAuth": []
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PaginatedTrueCompanyKeyPersonList"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"PaginatedTrueCompanyKeyPersonList": {
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"example": 10
},
"limit": {
"type": "integer",
"example": 10
},
"offset": {
"type": "integer",
"example": 10
},
"count": {
"type": "integer",
"example": 10
}
}
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TrueCompanyKeyPerson"
}
}
}
},
"TrueCompanyKeyPerson": {
"type": "object",
"properties": {
"person_id": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string",
"nullable": true
},
"beauhurst_url": {
"type": "string",
"format": "uri",
"readOnly": true
},
"linkedin_url": {
"type": "string",
"format": "uri",
"nullable": true
},
"is_active": {
"type": "boolean"
},
"title": {
"type": "string",
"readOnly": true
},
"job_functions": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"is_founder": {
"type": "boolean",
"readOnly": true,
"description": "Was this person a founder?"
}
},
"required": [
"beauhurst_url",
"email",
"is_active",
"is_founder",
"linkedin_url",
"name",
"person_id",
"title"
]
}
},
"securitySchemes": {
"tokenAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "Token-based authentication with required prefix \"APIkey\""
}
}
},
"servers": [
{
"url": "/_api/v2.0"
}
]
}
```