---
updatedAt: 2026-04-24T15:12:04.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# Get the summary of a True Company
Get the summary of a single True Company including the classification, location, signals and key financials.
# 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}/summary": {
"get": {
"operationId": "truecompany_summary_retrieve",
"description": "Get the summary of a single True Company including the classification, location, signals and key financials.",
"summary": "Get the summary of a True Company",
"parameters": [
{
"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/TrueCompanySummaryResponse"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"ClassificationCodeTypeEnum": {
"enum": [
"SIC",
"WZ",
"NACE"
],
"type": "string"
},
"CorporateStructureNode": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Beauhurst True Company ID"
},
"name": {
"type": "string",
"description": "Legal entity name"
},
"company_registration_number": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Legal entity registration number"
},
"country": {
"type": "string",
"nullable": true,
"description": "Legal entity country"
}
},
"required": [
"company_registration_number",
"country",
"name",
"true_company_id"
]
},
"TrueCompanyClassificationCode": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Industry classification code"
},
"description": {
"type": "string",
"description": "Description of the classification code"
},
"group": {
"type": "string",
"readOnly": true,
"description": "Top-level group the code belongs to"
}
},
"required": [
"code",
"description",
"group"
]
},
"TrueCompanyHeadOfficeAddress": {
"type": "object",
"properties": {
"country": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Country of the address"
},
"address": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Street address"
},
"postcode": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Postcode"
}
},
"required": [
"address",
"country",
"postcode"
]
},
"TrueCompanyRegisteredAddress": {
"type": "object",
"properties": {
"country": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Country of the address"
},
"address": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Street address"
},
"postcode": {
"type": "string",
"readOnly": true,
"nullable": true,
"description": "Postcode"
}
},
"required": [
"address",
"country",
"postcode"
]
},
"TrueCompanySignals": {
"type": "object",
"properties": {
"growth": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of growth signals"
},
"innovation": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of innovation signals"
},
"environmental": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of environmental signals"
},
"social_and_governance": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of social & governance signals"
},
"risk": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of risk signals"
}
},
"required": [
"environmental",
"growth",
"innovation",
"risk",
"social_and_governance"
]
},
"TrueCompanyStageOfEvolutionTransition": {
"type": "object",
"properties": {
"primary_date": {
"type": "string",
"format": "date",
"description": "Date the stage of evolution changed"
},
"stage_before": {
"type": "string",
"nullable": true,
"description": "Stage of evolution before the change"
},
"stage_after": {
"type": "string",
"description": "Stage of evolution after the change"
}
},
"required": [
"primary_date",
"stage_after",
"stage_before"
]
},
"TrueCompanySummaryResponse": {
"type": "object",
"properties": {
"true_company_id": {
"type": "string",
"description": "Beauhurst True Company ID"
},
"name": {
"type": "string",
"description": "True Company name"
},
"corporate_register": {
"type": "string",
"nullable": true,
"description": "Corporate register"
},
"company_registration_number": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Company registration number"
},
"corporate_register_country": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Lowercase ISO 3166-1 alpha-2 code of the corporate registry's country"
},
"registered_name": {
"type": "string",
"nullable": true,
"description": "Registered name"
},
"other_trading_names": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "Other trading names for the company"
},
"registration_date": {
"type": "string",
"format": "date",
"nullable": true,
"description": "Date of company registration"
},
"cessation_date": {
"type": "string",
"format": "date",
"nullable": true,
"description": "Cessation date"
},
"company_status": {
"type": "string",
"description": "`Active`, `Administration order`, `Adverse info`, `Advised to inspect`, `Converted / Closed`, `Dissolved`, `Distressed`, `Dormant company`, `Inactive, Unspecified`, `In Administration`, `Liquidation`, `Moratorium`, `Unknown` or `Voluntary Arrangement`"
},
"description": {
"type": "string",
"nullable": true,
"description": "Description of the company"
},
"beauhurst_url": {
"type": "string",
"format": "uri",
"readOnly": true,
"description": "Beauhurst platform URL for the True Company"
},
"website": {
"type": "string",
"nullable": true,
"description": "Company website"
},
"all_websites": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of all websites, main website first"
},
"employee_count_range": {
"type": "string",
"nullable": true,
"description": "Range for most recent employee count"
},
"legal_form": {
"type": "string",
"nullable": true,
"description": "Legal form of the company"
},
"is_sme": {
"type": "boolean",
"nullable": true,
"description": "If the company is an SME"
},
"ultimate_parent_company": {
"allOf": [
{
"$ref": "#/components/schemas/CorporateStructureNode"
}
],
"readOnly": true,
"nullable": true,
"description": "Name, CRN and country of the ultimate parent company"
},
"latest_stage_of_evolution": {
"type": "string",
"nullable": true,
"description": "`Seed`, `Venture`, `Growth`, `Established`, `Zombie`, `Exited` or `Dead`"
},
"stage_of_evolution_transitions": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TrueCompanyStageOfEvolutionTransition"
},
"readOnly": true,
"description": "List of stage of evolution changes"
},
"last_modified_date": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": "Date last modified"
},
"industries": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of industries of the company"
},
"top_level_industry_groups": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "List of top level industry groups"
},
"buzzwords": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of buzzwords"
},
"classification_code_type": {
"allOf": [
{
"$ref": "#/components/schemas/ClassificationCodeTypeEnum"
}
],
"nullable": true,
"readOnly": true,
"description": "Industry classification scheme: SIC (UK), WZ (Germany) or NACE (Ireland)"
},
"classification_codes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TrueCompanyClassificationCode"
},
"readOnly": true,
"description": "List of industry codes, each with code, description and group"
},
"signals": {
"allOf": [
{
"$ref": "#/components/schemas/TrueCompanySignals"
}
],
"readOnly": true,
"description": "Growth, innovation, environmental, social & governance and risk signals. For more information see https://help.beauhurst.com/en/articles/9189499-what-are-signals"
},
"actively_hiring": {
"type": "string",
"readOnly": true,
"description": "If the company is currently hiring"
},
"target_markets": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of target markets"
},
"founder_female_percentage": {
"type": "number",
"format": "double",
"nullable": true,
"description": "Percentage of female founders"
},
"n_fundraisings": {
"type": "integer",
"description": "Number of fundraisings"
},
"total_amount_fundraisings": {
"type": "integer",
"description": "Total amount raised in fundraising"
},
"total_amount_fundraisings_currency": {
"type": "string",
"nullable": true,
"default": "GBP",
"description": "Currency code for `total_amount_fundraisings`"
},
"n_grants": {
"type": "integer",
"description": "Number of grants received"
},
"total_amount_grants": {
"type": "integer",
"description": "Total amount of grants received"
},
"total_amount_grants_currency": {
"type": "string",
"nullable": true,
"default": "GBP",
"description": "Currency code for `total_amount_grants`"
},
"latest_valuation": {
"type": "integer",
"nullable": true,
"description": "Latest valuation of the company"
},
"latest_valuation_currency": {
"type": "string",
"nullable": true,
"default": "GBP",
"description": "Currency code for `latest_valuation`"
},
"registered_address": {
"allOf": [
{
"$ref": "#/components/schemas/TrueCompanyRegisteredAddress"
}
],
"readOnly": true,
"description": "Registered address of the company"
},
"head_office_address": {
"allOf": [
{
"$ref": "#/components/schemas/TrueCompanyHeadOfficeAddress"
}
],
"readOnly": true,
"description": "Head office address of the company"
},
"phone_number": {
"type": "string",
"nullable": true,
"description": "Company phone number"
},
"x_handle": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "X (Twitter) handle"
},
"instagram_handle": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Instagram handle"
},
"pinterest_handle": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Pinterest handle"
},
"facebook_url": {
"type": "string",
"format": "uri",
"readOnly": true,
"nullable": true,
"description": "Facebook URL"
},
"glassdoor_url": {
"type": "string",
"format": "uri",
"readOnly": true,
"nullable": true,
"description": "Glassdoor URL"
},
"linkedin_url": {
"type": "string",
"format": "uri",
"readOnly": true,
"nullable": true,
"description": "LinkedIn URL"
},
"email_addresses": {
"type": "array",
"items": {
"type": "string"
},
"readOnly": true,
"description": "Company email addresses"
},
"banking_provider": {
"type": "string",
"nullable": true,
"description": "Banking provider"
},
"latest_accounts_currency": {
"type": "string",
"nullable": true,
"readOnly": true,
"description": "Currency of the latest accounts"
},
"latest_date_of_accounts": {
"type": "string",
"format": "date",
"nullable": true,
"readOnly": true,
"description": "Date the latest P&L accounts are made up to"
},
"latest_accounts_turnover": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Income earned from normal business activities, net of VAT."
},
"latest_accounts_operating_profit": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Earnings from core operations after deducting its operating costs."
},
"latest_accounts_ebitda": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Earnings before interest, taxes, depreciation and amortisation."
},
"latest_accounts_total_assets": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Total of fixed and current assets"
},
"latest_accounts_number_of_employees": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "The number of employees in the business."
},
"latest_accounts_cash": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Cash includes cash in hand and cash at bank."
},
"latest_accounts_total_liabilities": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Total of long-term and current liabilities"
},
"latest_accounts_net_assets": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Total assets less total liabilities"
},
"latest_credit_rating": {
"type": "integer",
"nullable": true,
"description": "Latest credit rating"
},
"credit_limit": {
"type": "integer",
"nullable": true,
"description": "Credit limit"
},
"credit_limit_currency": {
"type": "string",
"nullable": true,
"default": "GBP",
"description": "Currency code for `credit_limit`"
},
"total_number_of_charges": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Total number of charges the company has"
},
"number_of_outstanding_charges": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Number of outstanding charges"
},
"number_of_satisfied_charges": {
"type": "integer",
"nullable": true,
"readOnly": true,
"description": "Number of satisfied charges"
}
},
"required": [
"actively_hiring",
"all_websites",
"banking_provider",
"beauhurst_url",
"buzzwords",
"cessation_date",
"classification_code_type",
"classification_codes",
"company_registration_number",
"company_status",
"corporate_register",
"corporate_register_country",
"credit_limit",
"description",
"email_addresses",
"employee_count_range",
"facebook_url",
"founder_female_percentage",
"glassdoor_url",
"head_office_address",
"industries",
"instagram_handle",
"is_sme",
"last_modified_date",
"latest_accounts_cash",
"latest_accounts_currency",
"latest_accounts_ebitda",
"latest_accounts_net_assets",
"latest_accounts_number_of_employees",
"latest_accounts_operating_profit",
"latest_accounts_total_assets",
"latest_accounts_total_liabilities",
"latest_accounts_turnover",
"latest_credit_rating",
"latest_date_of_accounts",
"latest_stage_of_evolution",
"latest_valuation",
"legal_form",
"linkedin_url",
"n_fundraisings",
"n_grants",
"name",
"number_of_outstanding_charges",
"number_of_satisfied_charges",
"other_trading_names",
"phone_number",
"pinterest_handle",
"registered_address",
"registered_name",
"registration_date",
"signals",
"stage_of_evolution_transitions",
"target_markets",
"top_level_industry_groups",
"total_amount_fundraisings",
"total_amount_grants",
"total_number_of_charges",
"true_company_id",
"ultimate_parent_company",
"website",
"x_handle"
]
}
},
"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": {}
}
```