Entity

The Entity object represents a legal entity (company) or natural person returned from a registry search.

Fields

Core

Field	Type	Description
_id	string	Unique entity identifier within the case graph
_entityURL	string	URL of the entity’s page in the source registry

Company attributes

Field	Type	Description
legalName	string	Official registered name
legalForm	string	Legal form (e.g. GmbH, Ltd, S.A., Inc.)
companyStatus	string	Current status (e.g. Active, Dissolved)
companyURL	string	Company website URL
countryOfRegistration	string	ISO country code of registration
jurisdiction	string	Specific jurisdiction code (e.g. US-DE)
registrationDate	string	Date of registration / incorporation
company_size	string	Size band when available
number_of_employees	number	Employee count when available
lei	LEI	Global Legal Entity Identifier record (after LEI lookup)

Person attributes

When the entity is a natural person (officer, shareholder, UBO), these fields may be populated instead:

Field	Type	Description
givenName	string	First name
middleName	string	Middle name
surname	string	Last name
fullName	string	Full name as a single string
dateOfBirth	string	Date of birth
nationality	string	Nationality
countryOfResidence	string	Country of residence
occupation	string	Occupation or profession

Nested objects

Field	Type	Description
addresses	Address[]	Registered, headquarters, and other addresses
activities	Activity[]	Business activities and industry codes
capital	Capital	Share capital and structure
financials	Financials	Financial metrics (when requested and available)
identifiers	Identifier[]	Registration numbers and tax IDs
otherNames	OtherName[]	Alternative, previous, or translated names
relationships	Relationship[]	Officers, shareholders, UBOs, etc.
sourceDocuments	SourceDocument[]	Proof documents from registries
counterparties	Entity[]	Related entities (nested Entity objects)
participations	Participation[]	Ownership / participation stakes when modelled separately

OtherName object

Field	Type	Description
name	string	The alternative name
language	string	Language code (e.g. en, de, ja)
nametype	string	One of: alias, native, previous, trading, translated, transliterated

SourceDocument object

Field	Type	Description
_documentID	string	Document ID for Document Retrieval
_entityID	string	ID of the associated entity
dateRetrieved	string	Date the document was retrieved
name	string	Document name / title
source	string	Source registry name

LEI object

Field	Type	Description
lei	string	20-character LEI code
legalName	string	Legal name from GLEIF
category	string	Entity category
lei_status	string	Registration status
last_update_date	string	Last GLEIF update
bic	string	BIC when present
otherNames	OtherName[]	Additional names from GLEIF

Example

{
  "_id": "550e8400-e29b-41d4-a716-446655440000",
  "_entityURL": "https://find-and-update.company-information.service.gov.uk/company/09215191",
  "legalName": "REVOLUT LTD",
  "legalForm": "Private Limited Company",
  "companyStatus": "Active",
  "countryOfRegistration": "GB",
  "jurisdiction": "GB",
  "registrationDate": "2014-07-01",
  "addresses": [
    {
      "_addressFormat": "raw",
      "_addressType": "Registered Address",
      "addressLine1": "7 Westferry Circus",
      "locality": "London",
      "postcode": "E14 4HD",
      "country": "GB"
    }
  ],
  "identifiers": [
    {
      "type": "Company number",
      "number": "09215191",
      "authority": "Companies House",
      "jurisdiction": "GB"
    }
  ],
  "activities": [
    {
      "activityCode": "64.19",
      "activityCodeType": "NACE",
      "activityDescription": "Other monetary intermediation",
      "mainActivity": true
    }
  ],
  "relationships": [
    {
      "natureOfRelationship": "Officer",
      "role": "Director",
      "_parentId": "counterparty-uuid"
    }
  ],
  "otherNames": [
    {
      "name": "Revolut",
      "nametype": "trading"
    }
  ],
  "sourceDocuments": [
    {
      "_documentID": "doc-abc-123",
      "_entityID": "550e8400-e29b-41d4-a716-446655440000",
      "dateRetrieved": "2026-01-15",
      "name": "Certificate of Incorporation",
      "source": "Companies House"
    }
  ],
  "counterparties": []
}