---
updatedAt: 2026-04-24T15:12:04.000Z
agentTools:
  projectIndex: https://docs.beauhurst.com/llms.txt
---

# Get UK Legal Entity data

Get registered details of UK Legal Entities

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Beauhurst API v2",
    "version": "1.0.0 (externalapi)",
    "description": "<h3>Usage</h3><p>The API only accepts <code>GET</code> requests over HTTPS.</p><h3>Authorization</h3><p>The Beauhurst API requires authentication in the form of an API key,provided in the format <code>'apikey <your-api-key>'</code>.<br><br>To obtain an API key, please contact your subscription's account manager at Beauhurst. Be sure to keep this key <strong>private</strong> and <strong>secure</strong>.</p>"
  },
  "paths": {
    "/legalentity/gb/{company_registration_number}/summary": {
      "get": {
        "operationId": "legalentity_gb_summary_retrieve",
        "description": "Get registered details of UK Legal Entities",
        "summary": "Get UK Legal Entity data",
        "parameters": [
          {
            "in": "path",
            "name": "company_registration_number",
            "schema": {
              "type": "string"
            },
            "description": "Companies House ID for the legal entity",
            "required": true
          }
        ],
        "tags": [
          "legalentity"
        ],
        "security": [
          {
            "tokenAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UKLegalEntitySummary"
                }
              }
            },
            "description": ""
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "UKLegalEntitySummary": {
        "type": "object",
        "properties": {
          "company_registration_number": {
            "type": "string",
            "description": "Company registration number of the LE"
          },
          "true_company_id": {
            "type": "string",
            "nullable": true,
            "description": "Beauhurst True Company ID"
          },
          "registered_name": {
            "type": "string",
            "description": "Registered name of the LE"
          },
          "beauhurst_url": {
            "type": "string",
            "readOnly": true,
            "description": "Beauhurst URL of the LE"
          },
          "incorporation_date": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Incorporation date of the LE"
          },
          "cessation_date": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Cessation date of the LE"
          },
          "legal_form": {
            "type": "string",
            "nullable": true,
            "description": "Legal form"
          },
          "registered_address": {
            "type": "string",
            "nullable": true,
            "description": "Registered address"
          },
          "registered_postcode": {
            "type": "string",
            "nullable": true,
            "description": "Registered postcode"
          },
          "latest_accounts_currency": {
            "type": "string",
            "nullable": true,
            "description": "Currency of the latest accounts"
          },
          "latest_date_of_accounts": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Date the latest P&L accounts are made up to"
          },
          "latest_accounts_turnover": {
            "type": "integer",
            "nullable": true,
            "description": "Income earned from normal business activities, net of VAT"
          },
          "latest_accounts_operating_profit": {
            "type": "integer",
            "nullable": true,
            "description": "Earnings from core operations after deducting its operating costs"
          },
          "latest_accounts_ebitda": {
            "type": "integer",
            "nullable": true,
            "description": "Earnings before interest, taxes, depreciation and amortisation"
          },
          "latest_accounts_total_assets": {
            "type": "integer",
            "nullable": true,
            "description": "Total of fixed and current assets"
          },
          "latest_accounts_number_of_employees": {
            "type": "integer",
            "nullable": true,
            "description": "Total number of personnel employed by the company"
          },
          "latest_accounts_cash": {
            "type": "integer",
            "nullable": true,
            "description": "Cash includes cash in hand and cash at bank"
          },
          "latest_accounts_total_liabilities": {
            "type": "integer",
            "nullable": true,
            "description": "Total of long-term and current liabilities"
          },
          "latest_accounts_net_assets": {
            "type": "integer",
            "nullable": true,
            "description": "Total assets less total liabilities"
          },
          "companies_house_status": {
            "type": "string",
            "default": "Unknown",
            "description": "Companies House status"
          },
          "sic_codes": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            },
            "readOnly": true,
            "description": "SIC codes"
          }
        },
        "required": [
          "beauhurst_url",
          "cessation_date",
          "company_registration_number",
          "incorporation_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_date_of_accounts",
          "legal_form",
          "registered_address",
          "registered_name",
          "registered_postcode",
          "sic_codes",
          "true_company_id"
        ]
      }
    },
    "securitySchemes": {
      "tokenAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "Token-based authentication with required prefix \"APIkey\""
      }
    }
  },
  "servers": [
    {
      "url": "/_api/v2.0"
    }
  ]
}
```