FirstLink API Products Documentation
Entity Reports
Entity Insight
Provides a detailed global verification, including ownership and subsidiary structures, for thorough compliance reviews. Online Instant or 24 hour SLA turnaround if not instantly available.
{
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [],
"properties": {
"entity_data": {
"order": 1,
"required": [
"entity_id",
"identity"
],
"properties": {
"entity": {
"$id": "https://firstlink.world/schemas/sections/identity.json",
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Core identity information for an entity",
"order": 1,
"properties": {
"address_line_1": {
"description": "Primary address line",
"maxLength": 255,
"order": 4,
"type": "string"
},
"address_line_2": {
"description": "Secondary address line",
"maxLength": 255,
"order": 5,
"type": "string"
},
"address_line_3": {
"description": "Third address line",
"maxLength": 255,
"order": 6,
"type": "string"
},
"address_line_4": {
"description": "Fourth address line",
"maxLength": 255,
"order": 7,
"type": "string"
},
"city": {
"description": "City name",
"maxLength": 100,
"order": 9,
"type": "string"
},
"country": {
"description": "Country name",
"enum": [
"Malta",
"Italy",
"United Kingdom",
"Germany",
"France",
"Spain",
"Netherlands",
"Belgium"
],
"order": 11,
"type": "string"
},
"country_code": {
"description": "Country code",
"order": 12,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"country_dial_code": {
"description": "country dial code",
"order": 15,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"country_iso_a3": {
"description": "ISO 3-letter country code",
"order": 13,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"country_iso_number": {
"description": "ISO number",
"order": 14,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"county": {
"description": "County or region",
"maxLength": 100,
"order": 10,
"type": "string"
},
"entity_id": {
"description": "Unique entity identifier",
"maxLength": 50,
"order": 1,
"pattern": "^[A-Z]{2}[0-9]{10}$",
"type": "string"
},
"entity_name": {
"description": "Official entity name",
"maxLength": 255,
"minLength": 1,
"order": 2,
"type": "string"
},
"last_annual_return": {
"description": "Last Annual Return",
"order": 17,
"type": "string"
},
"last_approval_date": {
"description": "Last Approval Date",
"order": 19,
"type": "string"
},
"last_general_meeting": {
"description": "Last General Meeting date",
"order": 18,
"type": "string"
},
"postcode": {
"description": "Postal code",
"maxLength": 20,
"order": 8,
"type": "string"
},
"termination_reason": {
"description": "Reason for termination",
"order": 16,
"type": "string"
},
"trading_name": {
"description": "Trading or commercial name",
"maxLength": 255,
"order": 3,
"type": "string"
},
"number_of_employees": {
"order": 255,
"type": "string",
"description": "Number of employees"
}
},
"required": [
"entity_name",
"city",
"country"
],
"title": "Entity Identity Information",
"type": "object"
},
"registered_names": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 2,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 4,
"type": [
"string",
"null"
],
"description": "Date of cancellation / struck off (YYYY-MM-DD)"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Registered Name Status: 0 = inactive, 1 = active"
},
"name_type": {
"order": 5,
"type": "string",
"description": "Registered Name Type"
},
"name": {
"maxLength": 255,
"order": 7,
"type": "string",
"minLength": 1,
"description": "Registered Name"
},
"record_number": {
"order": 1,
"type": "integer",
"minimum": 1,
"description": "Sequential record identifier"
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 3,
"type": [
"string",
"null"
],
"description": "Date of registration / incorporation (YYYY-MM-DD)"
},
"name_code": {
"order": 6,
"type": "string",
"description": "Registered Name Code"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/registered_name.json",
"title": "Registered Name",
"description": "A registered name entry"
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/registered_names.json",
"title": "Registered Names",
"description": "Historical and current registered names for the entity",
"array_ordering": {
"order_fields": [
"record_number",
"name",
"status",
"name_type",
"name_code",
"start_date",
"end_date"
]
}
},
"registered_offices": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 3,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"registration_office": {
"order": 5,
"type": "string",
"description": "Name of the registration office"
},
"end_date": {
"order": 4,
"type": [
"string",
"null"
],
"description": "Date of cancellation / struck off (YYYY-MM-DD)"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Registered office status: 0=inactive, 1=active"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"start_date": {
"order": 3,
"type": [
"string",
"null"
],
"description": "Date of registration / incorporation (YYYY-MM-DD)"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/registered_office.json",
"title": "Registered Offices",
"description": "Registration authority information"
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/registrations.json",
"title": "Registrations",
"description": "Registration authorities and offices",
"array_ordering": {
"order_fields": [
"record_number",
"registration_office",
"status",
"start_date",
"end_date"
]
}
},
"identifiers": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 4,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id_key": {
"order": 7,
"type": "string",
"description": "Identification number",
"minLength": 1
},
"end_date": {
"order": 4,
"type": [
"string",
"null"
],
"description": "Date of cancellation / struck off (YYYY-MM-DD)"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Identification number status: 0=inactive, 1=active"
},
"id_name": {
"order": 6,
"type": [
"string",
"null"
],
"description": "Identification number name"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"start_date": {
"order": 3,
"type": [
"string",
"null"
],
"description": "Date of registration / incorporation (YYYY-MM-DD)"
},
"id_type": {
"order": 5,
"type": "string",
"enum": [
"VAT",
"COM",
"REG",
"TAX"
],
"description": "Identification number type"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/identifier.json",
"title": "Identification Key",
"description": "Official identification number"
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/id_keys.json",
"title": "Identification numbers",
"description": "Official identification numbers and keys for the entity",
"array_ordering": {
"order_fields": [
"record_number",
"id_key",
"status",
"id_type",
"id_name",
"start_date",
"end_date"
]
}
},
"addresses": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 9,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_number",
"status",
"country_code",
"country"
],
"properties": {
"county": {
"order": 15,
"type": [
"string",
"null"
],
"description": "County or state"
},
"country": {
"order": 17,
"type": "string",
"description": "Country name"
},
"address_line_1": {
"maxLength": 255,
"order": 7,
"type": [
"string",
"null"
],
"description": "Primary address line"
},
"address_code": {
"order": 5,
"type": "string",
"description": "Address type code"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"order": 16,
"type": "string",
"description": "ISO 2-letter country code"
},
"street_name": {
"order": 11,
"type": [
"string",
"null"
],
"description": "Street name"
},
"end_date": {
"order": 4,
"type": [
"string",
"null"
],
"description": "Address validity end date"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "1 = Active, 0 = Inactive"
},
"address_line_2": {
"maxLength": 255,
"order": 8,
"type": [
"string",
"null"
],
"description": "Secondary address line"
},
"address_type": {
"order": 6,
"type": [
"string",
"null"
],
"description": "Address type description"
},
"city": {
"order": 14,
"type": [
"string",
"null"
],
"description": "City name"
},
"address_line_4": {
"maxLength": 255,
"order": 10,
"type": [
"string",
"null"
],
"description": "Fourth address line"
},
"address_line_3": {
"maxLength": 255,
"order": 9,
"type": [
"string",
"null"
],
"description": "Third address line"
},
"postcode": {
"order": 13,
"type": [
"string",
"integer",
"null"
],
"description": "Postal code"
},
"street_number": {
"order": 12,
"type": [
"string",
"null"
],
"description": "Street number"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"order": 3,
"type": [
"string",
"null"
],
"description": "Address validity start date"
},
"full_address": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Full address"
}
},
"type": "array",
"$id": "https://firstlink.world/schemas/types/address.json",
"title": "Address",
"description": "Physical or mailing address"
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/addresses.json",
"title": "Entity Addresses",
"description": "Physical and registered addresses for the entity",
"array_ordering": {
"order_fields": [
"record_number",
"status",
"start_date",
"end_date",
"address_code",
"address_type",
"full_address",
"address_line_1",
"address_line_2",
"address_line_3",
"address_line_4",
"street_name",
"street_number",
"postcode",
"city",
"county",
"country_code",
"country"
]
}
},
"attributes": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 5,
"properties": {
"legal_forms": {
"order": 1,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"legal_form_type": {
"order": 4,
"type": "string",
"description": "Type of legal entity structure (e.g., Corporation, LLC, Partnership)"
},
"legal_form_code": {
"order": 3,
"type": "string",
"description": "Standardized code identifying the legal form type"
},
"end_date": {
"order": 6,
"type": [
"string",
"null"
],
"description": "Date when the legal form classification ended or became inactive"
},
"status": {
"order": 2,
"type": "string",
"description": "1 = Active, 0 = Inactive - indicates if the legal form is currently valid, other values also possible"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"start_date": {
"order": 5,
"type": [
"string",
"null"
],
"description": "Date when the legal form classification became effective"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/legal_form.json",
"title": "Legal Form",
"description": "Legal form classification"
},
"type": "array",
"description": "Legal Forms"
},
"company_statuses": {
"order": 2,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"end_date": {
"order": 6,
"type": [
"string",
"null"
],
"description": "Date when the company status ended or changed"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "1 = Active, 0 = Inactive - indicates if the company status is currently valid"
},
"status_code": {
"order": 3,
"type": "string",
"description": "Standardized code identifying the company status"
},
"status_type": {
"order": 4,
"type": "string",
"enum": [
"active",
"inactive",
"dissolved",
"suspended"
],
"description": "Current operational status of the company (active, inactive, dissolved, suspended)"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"order": 5,
"type": [
"string",
"null"
],
"description": "Date when the company status became effective"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/company_status.json",
"title": "Company Status",
"description": "Current operating status of the company"
},
"type": "array",
"description": "Company Statuses"
},
"listed_code": {
"order": 3,
"type": "integer",
"enum": [
0,
1
],
"description": "Stock exchange listing status"
},
"is_ultimate_parent": {
"order": 4,
"type": "integer",
"enum": [
0,
1
],
"description": "Ultimate parent company flag"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/attributes.json",
"title": "Attributes",
"description": "Legal forms, company statuses, and other legal classifications"
},
"classification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 10,
"properties": {
"service": {
"order": 4,
"type": "integer",
"enum": [
0,
1
],
"description": "Service activity flag"
},
"retail": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Retail activity flag"
},
"manufacture": {
"order": 3,
"type": "integer",
"enum": [
0,
1
],
"description": "Manufacturing activity flag"
},
"business_lines": {
"order": 6,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"line_of_business_code": {
"order": 1,
"type": "integer",
"description": "Line of business classification code"
},
"line_of_business_text": {
"order": 2,
"type": "string",
"description": "Line of business description"
},
"record_number": {
"order": 3,
"type": "integer",
"description": ""
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/business_line.json",
"title": "Business Line",
"description": "Line of business classification"
},
"type": "array",
"description": "Business line classifications",
"array_ordering": {
"order_fields": [
"line_of_business_code",
"line_of_business_text",
"record_number"
]
}
},
"wholesale": {
"order": 1,
"type": "integer",
"enum": [
0,
1
],
"description": "Wholesale activity flag"
},
"nace_codes": {
"order": 5,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_number",
"classification_code",
"classification_text",
"classification_system"
],
"properties": {
"nace_text": {
"order": 3,
"type": "string",
"description": "Industry classification description",
"minLength": 1
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"nace_code": {
"order": 2,
"maximum": 999999,
"type": "integer",
"description": "Industry classification code number",
"minimum": 1
}
},
"type": "array",
"$id": "https://firstlink.world/schemas/types/industry_code.json",
"title": "NACE Classification",
"description": "NACE classification"
},
"type": "array",
"description": "Array of industry classification codes",
"array_ordering": {
"order_fields": [
"record_number",
"nace_code",
"nace_text"
]
}
},
"industry_codes": {
"order": 6,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [],
"properties": {
"industry_code": {
"order": 2,
"maximum": 999999,
"type": "integer",
"description": "Industry classification code number",
"minimum": 1
},
"industry_text": {
"order": 3,
"type": "string",
"description": "Industry classification description",
"minLength": 1
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
}
},
"type": "array",
"$id": "https://firstlink.world/schemas/types/industry_code.json",
"title": "Industry Classification",
"description": "Industry classification"
},
"type": "array",
"description": "Array of industry classification codes",
"array_ordering": {
"order_fields": [
"record_number",
"industry_code",
"industry_text"
]
}
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/business_classification.json",
"title": "Business Classification",
"description": "Business activity classifications and industry codes"
},
"history": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 26,
"properties": {
"history_records": {
"order": 1,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_number",
"year",
"history_code",
"history_type"
],
"properties": {
"history_code": {
"order": 3,
"type": "string",
"description": "Historic milestone (code)"
},
"year": {
"order": 2,
"maximum": 2100,
"type": "integer",
"description": "Year of historical event",
"minimum": 1800
},
"history_text": {
"order": 5,
"type": [
"string",
"null"
],
"description": "Description of the historic milestone"
},
"history_type": {
"order": 4,
"type": "string",
"description": "Historic milestone (text)"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/history_record.json",
"title": "History",
"description": "Historical event or milestone"
},
"type": "array",
"description": "Array of historical records",
"array_ordering": {
"order_fields": [
"record_number",
"year",
"history_code",
"history_type",
"history_text"
]
}
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/history.json",
"title": "Entity History",
"description": "Historical events and milestones for the entity"
},
"crossborder": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 12,
"properties": {
"agent": {
"order": 3,
"type": "integer",
"enum": [
0,
1
],
"description": "Trade agent flag"
},
"foreign_purchase": {
"order": 5,
"type": [
"number",
"null"
],
"description": "Foreign purchase volume or percentage"
},
"foreign_sales": {
"order": 4,
"type": [
"number",
"null"
],
"description": "Foreign sales volume or percentage"
},
"importer": {
"order": 1,
"type": "integer",
"enum": [
0,
1
],
"description": "Import activity flag"
},
"exporter": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Export activity flag"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/crossborder.json",
"title": "Entity Crossborder Information",
"description": "International trade and cross-border business information"
},
"ownership": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 17,
"properties": {
"threshold": {
"order": 5,
"type": "integer",
"description": "Threshold"
},
"ultimate_parent": {
"order": 29,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"full_name"
],
"properties": {
"origin": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
},
"end_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End date of involvement"
},
"range_type": {
"order": 12,
"type": "string",
"description": "Range/Class text of interest based on voting rights"
},
"entity_type": {
"order": 3,
"type": "string",
"enum": [
"i",
"c",
"m"
],
"description": "Type (i=individual, c=corporate, m=mixed)"
},
"country_iso_number": {
"pattern": "^[A-Z]{2}$",
"order": 25,
"type": "string",
"description": "ISO number"
},
"full_name": {
"maxLength": 255,
"order": 10,
"type": "string",
"description": "Full name of person/entity",
"minLength": 1
},
"entity_id": {
"order": 7,
"type": "string",
"description": "WorldBox Identification Number"
},
"in_capital": {
"multipleOf": 0.01,
"order": 14,
"maximum": 100,
"type": "number",
"description": "Percentage share of company capital",
"minimum": 0
},
"nickname": {
"order": 14,
"type": [
"string",
"null"
],
"description": "Nickname"
},
"first_name": {
"order": 12,
"type": [
"string",
"null"
],
"description": "First name"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End date of involvement"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"address_line_2": {
"order": 19,
"type": [
"string",
"null"
],
"description": "Address line 2"
},
"currency_code": {
"pattern": "^[A-Z]{3}$",
"order": 17,
"type": "string",
"description": "Currency code (ISO 4217, alpha 3-code)"
},
"in_voting_right": {
"multipleOf": 0.01,
"order": 13,
"maximum": 100,
"type": "number",
"description": "Percentage share of voting rights based on all issued shares",
"minimum": 0
},
"birth_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 27,
"type": [
"string",
"null"
],
"description": "Birth date"
},
"last_name": {
"order": 13,
"type": [
"string",
"null"
],
"description": "Last name"
},
"died_date": {
"order": 28,
"type": [
"string",
"null"
]
},
"birth_year": {
"order": 28,
"maximum": 2100,
"type": [
"integer",
"null"
],
"description": "Birth year",
"minimum": 1900
},
"city": {
"order": 17,
"type": "string",
"description": "City of residence/incorporation"
},
"address_line_3": {
"order": 20,
"type": [
"string",
"null"
],
"description": "Address line 3"
},
"range_code": {
"order": 11,
"type": "string",
"description": "Range/Class code of interest based on voting rights"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"amount": {
"multipleOf": 0.01,
"order": 16,
"type": "number",
"description": "Total amount of shares/warranty held",
"minimum": 0
},
"email": {
"order": 26,
"type": [
"string",
"null"
],
"description": "Email address",
"format": "email"
},
"county": {
"order": 22,
"type": [
"string",
"null"
],
"description": "County"
},
"died_year": {
"order": 28,
"type": [
"integer",
"null"
],
"description": "Died year"
},
"country_iso_a3": {
"pattern": "^[A-Z]{2}$",
"order": 24,
"type": "string",
"description": "ISO 3-letter country code"
},
"country": {
"order": 16,
"type": "string",
"description": "Country of residence/incorporation"
},
"died": {
"order": 29,
"type": "integer",
"enum": [
0,
1
],
"description": "Deceased flag (0=alive, 1=deceased)"
},
"start_year": {
"order": 6,
"maximum": 2100,
"type": "integer",
"description": "Year of registration/start of ownership",
"minimum": 1800
},
"level": {
"order": 4,
"type": "integer",
"description": "Ownership level",
"minimum": 0
},
"origin_countries": {
"order": 31,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country_code"
],
"properties": {
"country_code": {
"type": "string",
"description": "Country code",
"order": 2
},
"country": {
"type": "string",
"description": "Country name",
"order": 3
},
"record_number": {
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1,
"order": 1
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/origin_country.json",
"title": "Origin country",
"description": "Origin country"
},
"type": "array",
"description": "Origin countries",
"array_ordering": {
"order_fields": [
"record_number",
"country_code",
"country"
]
}
},
"address_line_1": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address line 1"
},
"direct": {
"order": 10,
"type": "integer",
"enum": [
0,
1
],
"description": "Relation type: 1=direct interest, 0=indirect or unknown"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"order": 23,
"type": "string",
"description": "ISO 2-letter country code"
},
"gender": {
"order": 9,
"type": "string",
"enum": [
"M",
"F",
"C"
],
"description": "Gender (M=Male, F=Female, C=Corporate)"
},
"profession": {
"order": 30,
"type": [
"string",
"null"
],
"description": "Profession or business type"
},
"address_resident": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address Resident"
},
"quantity": {
"order": 15,
"type": "integer",
"description": "Quantity of shares held",
"minimum": 0
},
"local_name": {
"order": 15,
"type": [
"string",
"null"
],
"description": "Local name variant"
},
"currency": {
"order": 18,
"type": "string",
"description": "Currency name (ISO 4217, text)"
},
"reference_id": {
"order": 8,
"type": "string",
"description": "Reference ID"
},
"title": {
"order": 11,
"type": [
"string",
"null"
],
"description": "Title or position"
},
"postcode": {
"order": 21,
"type": [
"string",
"null"
],
"description": "ZIP/Postal code"
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"origin_city": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/ultimate_parent.json",
"title": "Ultimate Parent",
"description": "Individual person or corporate entity"
},
"type": "array",
"description": "",
"array_ordering": {
"order_fields": [
"record_number",
"status",
"entity_type",
"level",
"start_date",
"end_year",
"end_date",
"start_year",
"entity_id",
"reference_id",
"gender",
"full_name",
"direct",
"range_code",
"title",
"range_type",
"first_name",
"in_voting_right",
"last_name",
"in_capital",
"nickname",
"quantity",
"local_name",
"amount",
"country",
"currency_code",
"city",
"address_line_1",
"address_resident",
"currency",
"address_line_2",
"address_line_3",
"postcode",
"county",
"country_code",
"country_iso_a3",
"country_iso_number",
"email",
"birth_date",
"died_date",
"birth_year",
"died_year",
"died",
"profession",
"origin",
"origin_countries",
"origin_city"
]
}
},
"structure": {
"order": 6,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_number",
"status",
"owner_entity_id",
"child_entity_id",
"entity_type"
],
"properties": {
"owners": {
"order": 32,
"items": {
"required": [
"record_number",
"status",
"owner_entity_id",
"child_entity_id",
"entity_type"
],
"properties": {
"owners": {
"type": [
"array",
"null"
],
"order": 32,
"description": "Recursive array of ownership relationships"
},
"entity_type": {
"type": "string",
"order": 6,
"enum": [
"C",
"P"
],
"description": "Entity type: C = Company, P = Person"
},
"in_capital": {
"type": [
"number",
"null"
],
"order": 10,
"description": "Percentage of capital ownership"
},
"person_dob": {
"type": [
"string",
"null"
],
"order": 27,
"format": "date",
"description": "Person date of birth"
},
"step_level": {
"type": "integer",
"order": 31,
"description": "Level in the ownership hierarchy"
},
"status": {
"type": "integer",
"order": 2,
"enum": [
0,
1
],
"description": "1 = Active, 0 = Inactive"
},
"end_date": {
"type": [
"string",
"null"
],
"order": 13,
"format": "date",
"description": "End date of ownership relationship"
},
"person_address_country_code": {
"type": [
"string",
"null"
],
"order": 29,
"description": "Person address country code"
},
"company_county": {
"type": [
"string",
"null"
],
"order": 17,
"description": "County/state where company is registered"
},
"in_voting_right": {
"type": [
"number",
"null"
],
"order": 9,
"description": "Percentage of voting rights"
},
"person_address_zip": {
"type": [
"string",
"null"
],
"order": 25,
"description": "Person ZIP/postal code"
},
"effective_ownership": {
"type": [
"number",
"null"
],
"order": 30,
"description": "Effective ownership percentage"
},
"record_number": {
"type": "integer",
"order": 1,
"description": "Relationship sequence number"
},
"range_code": {
"type": "string",
"order": 8,
"description": "Ownership range classification code"
},
"company_legal_form": {
"type": [
"string",
"null"
],
"order": 20,
"description": "Legal form of the company"
},
"company_name": {
"type": [
"string",
"null"
],
"order": 14,
"description": "Name of the company (if entity_type = C)"
},
"cross_ownership": {
"type": "boolean",
"order": 3,
"description": "Indicates if this is a cross-ownership relationship"
},
"company_status": {
"type": [
"string",
"null"
],
"order": 19,
"description": "Company status: ACT = Active, DIS = Dissolved"
},
"person_first_name": {
"type": [
"string",
"null"
],
"order": 21,
"description": "First name (if entity_type = P)"
},
"start_year": {
"type": [
"integer",
"null"
],
"order": 12,
"description": "Start year of ownership relationship"
},
"company_city": {
"type": [
"string",
"null"
],
"order": 16,
"description": "City where company is registered"
},
"direct": {
"type": "integer",
"order": 7,
"description": "Direct ownership indicator"
},
"owner_entity_id": {
"type": "string",
"order": 4,
"description": "WIN identifier of the owning entity"
},
"person_last_name": {
"type": [
"string",
"null"
],
"order": 22,
"description": "Last name (if entity_type = P)"
},
"person_address_city": {
"type": [
"string",
"null"
],
"order": 26,
"description": "Person city"
},
"person_address_line_2": {
"type": [
"string",
"null"
],
"order": 24,
"description": "Person address line 2"
},
"company_country_code": {
"type": [
"string",
"null"
],
"order": 18,
"description": "ISO country code of company registration"
},
"child_entity_id": {
"type": "string",
"order": 5,
"description": "WIN identifier of the owned entity"
},
"company_register_number": {
"type": [
"string",
"null"
],
"order": 15,
"description": "Registration number"
},
"start_date": {
"type": [
"string",
"null"
],
"order": 11,
"format": "date",
"description": "Start date of ownership relationship"
},
"person_address_line_1": {
"type": [
"string",
"null"
],
"order": 23,
"description": "Person address line 1"
},
"person_origin_country_code": {
"type": [
"string",
"null"
],
"order": 28,
"description": "Person country of origin"
}
},
"additionalProperties": false,
"type": "object",
"title": "Ownership Relationship",
"description": "Recursive ownership relationship structure with unlimited nesting levels"
},
"type": [
"array",
"null"
],
"description": "Recursive array of ownership relationships"
},
"entity_type": {
"order": 6,
"type": "string",
"enum": [
"C",
"P"
],
"description": "Entity type: C = Company, P = Person"
},
"in_capital": {
"order": 10,
"type": [
"number",
"null"
],
"description": "Percentage of capital ownership"
},
"person_dob": {
"order": 27,
"type": [
"string",
"null"
],
"description": "Person date of birth",
"format": "date"
},
"step_level": {
"order": 31,
"type": "integer",
"description": "Level in the ownership hierarchy"
},
"end_date": {
"order": 13,
"type": [
"string",
"null"
],
"description": "End date of ownership relationship",
"format": "date"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "1 = Active, 0 = Inactive"
},
"person_address_country_code": {
"order": 29,
"type": [
"string",
"null"
],
"description": "Person address country code"
},
"company_county": {
"order": 17,
"type": [
"string",
"null"
],
"description": "County/state where company is registered"
},
"in_voting_right": {
"order": 9,
"type": [
"number",
"null"
],
"description": "Percentage of voting rights"
},
"person_address_zip": {
"order": 25,
"type": [
"string",
"null"
],
"description": "Person ZIP/postal code"
},
"effective_ownership": {
"order": 30,
"type": [
"number",
"null"
],
"description": "Effective ownership percentage"
},
"company_legal_form": {
"order": 20,
"type": [
"string",
"null"
],
"description": "Legal form of the company"
},
"range_code": {
"order": 8,
"type": "string",
"description": "Ownership range classification code"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Relationship sequence number"
},
"company_name": {
"order": 14,
"type": [
"string",
"null"
],
"description": "Name of the company (if entity_type = C)"
},
"cross_ownership": {
"order": 3,
"type": "boolean",
"description": "Indicates if this is a cross-ownership relationship"
},
"company_status": {
"order": 19,
"type": [
"string",
"null"
],
"description": "Company status: ACT = Active, DIS = Dissolved"
},
"person_first_name": {
"order": 21,
"type": [
"string",
"null"
],
"description": "First name (if entity_type = P)"
},
"start_year": {
"order": 12,
"type": [
"integer",
"null"
],
"description": "Start year of ownership relationship"
},
"company_city": {
"order": 16,
"type": [
"string",
"null"
],
"description": "City where company is registered"
},
"direct": {
"order": 7,
"type": "integer",
"description": "Direct ownership indicator"
},
"owner_entity_id": {
"order": 4,
"type": "string",
"description": "WIN identifier of the owning entity"
},
"person_last_name": {
"order": 22,
"type": [
"string",
"null"
],
"description": "Last name (if entity_type = P)"
},
"person_address_city": {
"order": 26,
"type": [
"string",
"null"
],
"description": "Person city"
},
"person_address_line_2": {
"order": 24,
"type": [
"string",
"null"
],
"description": "Person address line 2"
},
"company_country_code": {
"order": 18,
"type": [
"string",
"null"
],
"description": "ISO country code of company registration"
},
"child_entity_id": {
"order": 5,
"type": "string",
"description": "WIN identifier of the owned entity"
},
"company_register_number": {
"order": 15,
"type": [
"string",
"null"
],
"description": "Registration number"
},
"start_date": {
"order": 11,
"type": [
"string",
"null"
],
"description": "Start date of ownership relationship",
"format": "date"
},
"person_origin_country_code": {
"order": 28,
"type": [
"string",
"null"
],
"description": "Person country of origin"
},
"person_address_line_1": {
"order": 23,
"type": [
"string",
"null"
],
"description": "Person address line 1"
}
},
"additionalProperties": false,
"type": "object",
"$id": "https://firstlink.world/schemas/types/ubo_relationship.json",
"title": "Ownership Relationship",
"description": "Recursive ownership relationship structure with unlimited nesting levels"
},
"type": "array",
"description": "",
"array_ordering": {
"order_fields": [
"owners",
"entity_type",
"in_capital",
"person_dob",
"step_level",
"end_date",
"status",
"person_address_country_code",
"company_county",
"in_voting_right",
"person_address_zip",
"effective_ownership",
"record_number",
"range_code",
"company_legal_form",
"company_name",
"cross_ownership",
"company_status",
"person_first_name",
"start_year",
"company_city",
"direct",
"owner_entity_id",
"person_last_name",
"person_address_city",
"person_address_line_2",
"company_country_code",
"child_entity_id",
"company_register_number",
"start_date",
"person_origin_country_code",
"person_address_line_1"
]
}
},
"text_blocks": {
"order": 29,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"origin": {
"order": 207,
"pattern": "^[A-Z]{2}$",
"type": "string",
"description": "Country code of origin (ISO 3166-1 alpha-2)"
},
"language": {
"order": 208,
"pattern": "^[A-Z]{2}$",
"type": "string",
"description": "Language code (ISO 639-1 alpha-2)"
},
"text": {
"order": 209,
"type": "string",
"minLength": 1
},
"text_type": {
"order": 210,
"type": "string",
"description": "Type or category of the text content"
},
"effective_date": {
"order": 211,
"type": [
"string",
"null"
]
},
"end_date": {
"order": 212,
"type": [
"string",
"null"
]
},
"status": {
"order": 213,
"type": "integer",
"enum": [
0,
1
]
},
"text_code": {
"order": 214,
"type": "string",
"description": "Unique identifier code for the text block"
},
"record_number": {
"order": 215,
"type": "integer",
"description": "Sequential record identifier"
},
"start_date": {
"order": 216,
"type": [
"string",
"null"
]
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/text.json",
"title": "Text",
"description": "Text"
},
"type": "array",
"description": "Ownsership Texts",
"array_ordering": {
"order_fields": [
"origin",
"language",
"text",
"text_type",
"effective_date",
"end_date",
"status",
"text_code",
"record_number",
"start_date"
]
}
},
"code": {
"order": 204,
"type": "string",
"description": "Ownership code"
},
"number_of_owners": {
"order": 205,
"type": "string",
"description": "Number of owners"
},
"ultimate_beneficial_owner": {
"order": 7,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": "4",
"properties": {
"end_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 8,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"range_type": {
"pattern": "^(\\d+(-\\d+)?%|100%)$",
"order": 34,
"type": "string",
"description": "Shareholder percentage range"
},
"entity_type": {
"order": 3,
"type": "string",
"enum": [
"i",
"c",
"m"
],
"description": "Type (i=individual, c=corporate, m=mixed)"
},
"full_name": {
"maxLength": 255,
"order": 12,
"type": "string",
"description": "Full name of person/entity",
"minLength": 1
},
"entity_id": {
"order": 9,
"type": "string",
"description": "WorldBox Identification Number"
},
"in_capital": {
"order": 36,
"maximum": 100,
"type": "number",
"description": "Capital ownership percentage",
"minimum": 0
},
"nickname": {
"order": 16,
"type": [
"string",
"null"
],
"description": "Nickname"
},
"first_name": {
"order": 14,
"type": [
"string",
"null"
],
"description": "First name"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 7,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"address_line_2": {
"order": 21,
"type": [
"string",
"null"
],
"description": "Address line 2"
},
"in_voting_right": {
"order": 35,
"maximum": 100,
"type": "number",
"description": "Voting rights percentage",
"minimum": 0
},
"birth_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 27,
"type": [
"string",
"null"
],
"description": "Birth date"
},
"last_name": {
"order": 15,
"type": [
"string",
"null"
],
"description": "Last name"
},
"birth_year": {
"order": 28,
"maximum": 2100,
"type": [
"integer",
"null"
],
"description": "Birth year",
"minimum": 1900
},
"city": {
"order": 19,
"type": "string",
"description": "City of residence/incorporation"
},
"address_line_3": {
"order": 22,
"type": [
"string",
"null"
],
"description": "Address line 3"
},
"range_code": {
"order": 33,
"type": "string",
"description": "Ownership range code"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"email": {
"order": 26,
"type": [
"string",
"null"
],
"description": "Email address",
"format": "email"
},
"county": {
"order": 24,
"type": [
"string",
"null"
],
"description": "County"
},
"country": {
"order": 18,
"type": "string",
"description": "Country of residence/incorporation"
},
"died": {
"order": 29,
"type": "integer",
"enum": [
0,
1
],
"description": "Deceased flag (0=alive, 1=deceased)"
},
"start_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"level": {
"order": 4,
"type": "integer",
"description": "Ownership level",
"minimum": 0
},
"address_line_1": {
"order": 20,
"type": [
"string",
"null"
],
"description": "Address line 1"
},
"direct": {
"order": 32,
"type": "integer",
"enum": [
0,
1
],
"description": "Relation type"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"order": 25,
"type": "string",
"description": "ISO 2-letter country code"
},
"gender": {
"order": 11,
"type": "string",
"enum": [
"M",
"F",
"C"
],
"description": "Gender (M=Male, F=Female, C=Corporate)"
},
"profession": {
"order": 30,
"type": [
"string",
"null"
],
"description": "Profession or business type"
},
"local_name": {
"order": 17,
"type": [
"string",
"null"
],
"description": "Local name variant"
},
"reference_id": {
"order": 10,
"type": "string",
"description": "Reference ID"
},
"title": {
"order": 13,
"type": [
"string",
"null"
],
"description": "Title or position"
},
"postcode": {
"order": 23,
"type": [
"string",
"null"
],
"description": "ZIP/Postal code"
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"functions": {
"order": 31,
"oneOf": [
{
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"function_type"
],
"properties": {
"function_type": {
"order": 3,
"type": "string",
"description": "Type of function or role"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Date when the function ended (YYYY-MM-DD)"
},
"status": {
"order": 6,
"type": "integer",
"enum": [
0,
1
],
"description": "Function status: 0 = inactive, 1 = active"
},
"function_code": {
"order": 2,
"type": "integer",
"description": "Numeric code representing the function type"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 4,
"type": [
"string",
"null"
],
"description": "Date when the function started (YYYY-MM-DD)"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/function.json",
"title": "Function",
"description": "Person or Entities function/role within the company"
},
{
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"function_type"
],
"properties": {
"function_type": {
"order": 3,
"type": "string",
"description": "Type of function or role"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Date when the function ended (YYYY-MM-DD)"
},
"status": {
"order": 6,
"type": "integer",
"enum": [
0,
1
],
"description": "Function status: 0 = inactive, 1 = active"
},
"function_code": {
"order": 2,
"type": "integer",
"description": "Numeric code representing the function type"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 4,
"type": [
"string",
"null"
],
"description": "Date when the function started (YYYY-MM-DD)"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/function.json",
"title": "Function",
"description": "Person or Entities function/role within the company"
},
"type": "array"
}
],
"description": "Director functions - can be a single function or array of functions"
}
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/ultimate_beneficial_owner.json",
"title": "ultimate_beneficial_owner Information",
"description": "Array of ultimate_beneficial_owner"
},
"type": "array",
"description": "",
"array_ordering": {
"order_fields": [
"threshold",
"ubo_relationships",
"ultimate_beneficial_owner"
]
}
},
"type": {
"order": 206,
"type": "string",
"description": "Ownership type"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/ownership_text.json",
"title": "Ownership",
"description": "Ownership"
},
"financials": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 19,
"properties": {
"capital": {
"order": 88,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"capital_code": {
"order": 6,
"type": "string",
"description": "Capital code"
},
"capital_type": {
"order": 7,
"type": "string",
"description": "Capital type"
},
"paid_up": {
"order": 9,
"type": "number",
"description": "Paid up value",
"minimum": 0
},
"end_date": {
"order": 4,
"type": [
"string",
"null"
],
"description": "End date of the capital"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"capital_value": {
"order": 8,
"type": "number",
"description": "Capital value",
"minimum": 0
},
"currency": {
"order": 5,
"pattern": "^[A-Z]{3}$",
"type": "string",
"description": "Currency of the capital"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"order": 3,
"type": [
"string",
"null"
],
"description": "Start date of the capital"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/capital.json",
"title": "Capital",
"description": "Capital structure information"
},
"type": "array",
"array_ordering": {
"order_fields": [
"capital_code",
"capital_type",
"paid_up",
"end_date",
"status",
"capital_value",
"currency",
"record_number",
"start_date"
]
}
},
"capital_shares": {
"order": 90,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"share_code": {
"order": 6,
"type": "string",
"description": "Share code"
},
"end_date": {
"order": 4,
"type": [
"string",
"null"
],
"description": "End date of the share"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"share_type": {
"order": 7,
"type": "string",
"description": "Share type"
},
"quantity": {
"order": 8,
"type": "number",
"description": "Quantity of the share",
"minimum": 0
},
"value": {
"order": 9,
"type": "number",
"description": "Value of the share",
"minimum": 0
},
"class": {
"order": 10,
"type": "number",
"description": "Class of the share",
"minimum": 0
},
"currency": {
"order": 5,
"pattern": "^[A-Z]{3}$",
"type": "string",
"description": "Currency of the share"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1
},
"start_date": {
"order": 3,
"type": [
"string",
"null"
],
"description": "Start date of the share"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/capital_share_item.json",
"title": "Capital Share Item",
"description": "Capital structure information"
},
"type": "array",
"array_ordering": {
"order_fields": [
"share_code",
"end_date",
"status",
"share_type",
"quantity",
"value",
"class",
"currency",
"record_number",
"start_date"
]
}
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/financials.json",
"title": "Entity Financial Information",
"description": "Financial figures, capital information, and financial performance data for the entity"
},
"shareholders": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 13,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"full_name"
],
"properties": {
"origin": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
},
"end_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"range_type": {
"order": 2,
"pattern": "^(\\d+(-\\d+)?%|100%)$",
"type": "string",
"description": "Shareholder percentage range"
},
"entity_type": {
"order": 3,
"type": "string",
"enum": [
"i",
"c",
"m"
],
"description": "Type (i=individual, c=corporate, m=mixed)"
},
"full_name": {
"maxLength": 255,
"order": 10,
"type": "string",
"description": "Full name of person/entity",
"minLength": 1
},
"entity_id": {
"order": 7,
"type": "string",
"description": "WorldBox Identification Number"
},
"in_capital": {
"order": 3,
"maximum": 100,
"type": "number",
"description": "Capital ownership percentage",
"minimum": 0
},
"nickname": {
"order": 14,
"type": [
"string",
"null"
],
"description": "Nickname"
},
"first_name": {
"order": 12,
"type": [
"string",
"null"
],
"description": "First name"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"address_line_2": {
"order": 19,
"type": [
"string",
"null"
],
"description": "Address line 2"
},
"currency_code": {
"pattern": "^[A-Z]{3}$",
"order": 17,
"type": "string",
"description": "Currency code (ISO 4217, alpha 3-code)"
},
"in_voting_right": {
"order": 17,
"maximum": 100,
"type": "number",
"description": "Voting rights percentage",
"minimum": 0
},
"birth_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 25,
"type": [
"string",
"null"
],
"description": "Birth date"
},
"last_name": {
"order": 13,
"type": [
"string",
"null"
],
"description": "Last name"
},
"died_date": {
"order": 28,
"type": [
"string",
"null"
]
},
"birth_year": {
"order": 26,
"maximum": 2100,
"type": [
"integer",
"null"
],
"description": "Birth year",
"minimum": 1900
},
"city": {
"order": 17,
"type": "string",
"description": "City of residence/incorporation"
},
"address_line_3": {
"order": 20,
"type": [
"string",
"null"
],
"description": "Address line 3"
},
"range_code": {
"order": 18,
"type": "string",
"description": "Ownership range code"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"amount": {
"multipleOf": 0.01,
"order": 16,
"type": "number",
"description": "Total amount of shares/warranty held",
"minimum": 0
},
"email": {
"order": 24,
"type": [
"string",
"null"
],
"description": "Email address",
"format": "email"
},
"county": {
"order": 22,
"type": [
"string",
"null"
],
"description": "County"
},
"died_year": {
"order": 28,
"type": [
"integer",
"null"
],
"description": "Died year"
},
"country": {
"order": 16,
"type": "string",
"description": "Country of residence/incorporation"
},
"died": {
"order": 27,
"type": "integer",
"enum": [
0,
1
],
"description": "Deceased flag (0=alive, 1=deceased)"
},
"start_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"level": {
"order": 4,
"type": "integer",
"description": "Ownership level",
"minimum": 0
},
"origin_countries": {
"order": 31,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country_code"
],
"properties": {
"country_code": {
"type": "string",
"description": "Country code",
"order": 2
},
"country": {
"type": "string",
"description": "Country name",
"order": 3
},
"record_number": {
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1,
"order": 1
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/origin_country.json",
"title": "Origin country",
"description": "Origin country"
},
"type": "array",
"description": "Origin countries",
"array_ordering": {
"order_fields": [
"record_number",
"country_code",
"country"
]
}
},
"address_line_1": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address line 1"
},
"direct": {
"order": 19,
"type": "integer",
"enum": [
0,
1
],
"description": "Relation type"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"order": 23,
"type": "string",
"description": "ISO 2-letter country code"
},
"gender": {
"order": 9,
"type": "string",
"enum": [
"M",
"F",
"C"
],
"description": "Gender (M=Male, F=Female, C=Corporate)"
},
"profession": {
"order": 28,
"type": [
"string",
"null"
],
"description": "Profession or business type"
},
"address_resident": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address Resident"
},
"quantity": {
"order": 15,
"type": "integer",
"description": "Quantity of shares held",
"minimum": 0
},
"local_name": {
"order": 15,
"type": [
"string",
"null"
],
"description": "Local name variant"
},
"currency": {
"order": 18,
"type": "string",
"description": "Currency name (ISO 4217, text)"
},
"reference_id": {
"order": 8,
"type": "string",
"description": "Reference ID"
},
"title": {
"order": 11,
"type": [
"string",
"null"
],
"description": "Title or position"
},
"postcode": {
"order": 21,
"type": [
"string",
"null"
],
"description": "ZIP/Postal code"
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"origin_city": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
},
"full_address": {
"order": 21,
"type": [
"string",
"null"
],
"description": "Full Address"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/shareholder.json",
"title": "Shareholder",
"description": "Shareholder"
},
"type": "array",
"$id": "https://firstlink.world/schemas/sections/shareholders.json",
"title": "Shareholders Information",
"description": "Array of shareholders/persons with ownership",
"array_ordering": {
"order_fields": [
"record_number",
"range_type",
"status",
"entity_type",
"in_capital",
"level",
"start_year",
"start_date",
"end_year",
"end_date",
"entity_id",
"reference_id",
"gender",
"full_name",
"title",
"first_name",
"last_name",
"nickname",
"quantity",
"local_name",
"amount",
"country",
"currency_code",
"in_voting_right",
"city",
"full_address",
"range_code",
"address_line_1",
"address_resident",
"currency",
"address_line_2",
"direct",
"address_line_3",
"postcode",
"county",
"country_code",
"email",
"birth_date",
"birth_year",
"died",
"died_date",
"died_year",
"profession",
"origin",
"origin_countries",
"origin_city"
]
}
},
"management": {
"$schema": "http://json-schema.org/draft-07/schema#",
"order": 15,
"properties": {
"directors": {
"order": 149,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"full_name"
],
"properties": {
"origin": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
},
"end_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"range_type": {
"order": 154,
"pattern": "^(\\d+(-\\d+)?%|100%)$",
"type": "string",
"description": "Shareholder percentage range"
},
"entity_type": {
"order": 3,
"type": "string",
"enum": [
"i",
"c",
"m"
],
"description": "Type (i=individual, c=corporate, m=mixed)"
},
"full_name": {
"maxLength": 255,
"order": 10,
"type": "string",
"description": "Full name of person/entity",
"minLength": 1
},
"entity_id": {
"order": 7,
"type": "string",
"description": "WorldBox Identification Number"
},
"in_capital": {
"order": 4,
"maximum": 100,
"type": "number",
"description": "Capital ownership percentage",
"minimum": 0
},
"nickname": {
"order": 14,
"type": [
"string",
"null"
],
"description": "Nickname"
},
"signature_type": {
"order": 32,
"type": [
"string",
"null"
],
"description": "Type of signature authority"
},
"first_name": {
"order": 12,
"type": [
"string",
"null"
],
"description": "First name"
},
"end_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End date of involvement"
},
"status": {
"order": 2,
"type": "integer",
"enum": [
0,
1
],
"description": "Record status: 0=inactive, 1=active"
},
"signature_restriction": {
"order": 33,
"type": [
"string",
"null"
],
"description": "Restrictions on signature authority"
},
"address_line_2": {
"order": 19,
"type": [
"string",
"null"
],
"description": "Address line 2"
},
"in_voting_right": {
"order": 155,
"maximum": 100,
"type": "number",
"description": "Voting rights percentage",
"minimum": 0
},
"birth_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 25,
"type": [
"string",
"null"
],
"description": "Birth date"
},
"last_name": {
"order": 13,
"type": [
"string",
"null"
],
"description": "Last name"
},
"died_date": {
"order": 28,
"type": [
"string",
"null"
]
},
"birth_year": {
"order": 26,
"maximum": 2100,
"type": [
"integer",
"null"
],
"description": "Birth year",
"minimum": 1900
},
"city": {
"order": 17,
"type": "string",
"description": "City of residence/incorporation"
},
"address_line_3": {
"order": 20,
"type": [
"string",
"null"
],
"description": "Address line 3"
},
"range_code": {
"order": 156,
"type": "string",
"description": "Ownership range code"
},
"record_number": {
"order": 1,
"type": "integer",
"description": "Sequential record identifier"
},
"email": {
"order": 24,
"type": [
"string",
"null"
],
"description": "Email address",
"format": "email"
},
"county": {
"order": 22,
"type": [
"string",
"null"
],
"description": "County"
},
"died_year": {
"order": 28,
"type": [
"integer",
"null"
],
"description": "Died year"
},
"warranty_currency": {
"pattern": "^[A-Z]{3}$",
"order": 34,
"type": [
"string",
"null"
],
"description": "Currency code for warranty amount (ISO 4217)"
},
"country": {
"order": 16,
"type": "string",
"description": "Country of residence/incorporation"
},
"died": {
"order": 27,
"type": "integer",
"enum": [
0,
1
],
"description": "Deceased flag (0=alive, 1=deceased)"
},
"start_year": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 6,
"type": [
"string",
"null"
],
"description": "End year of involvement"
},
"signature_code": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Code representing signature authority"
},
"level": {
"order": 4,
"type": "integer",
"description": "Ownership level",
"minimum": 0
},
"origin_countries": {
"order": 31,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country_code"
],
"properties": {
"country_code": {
"type": "string",
"description": "Country code",
"order": 2
},
"country": {
"type": "string",
"description": "Country name",
"order": 3
},
"record_number": {
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1,
"order": 1
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/origin_country.json",
"title": "Origin country",
"description": "Origin country"
},
"type": "array",
"description": "Origin countries",
"array_ordering": {
"order_fields": [
"record_number",
"country_code",
"country"
]
}
},
"address_line_1": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address line 1"
},
"direct": {
"order": 157,
"type": "integer",
"enum": [
0,
1
],
"description": "Relation type"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"order": 23,
"type": "string",
"description": "ISO 2-letter country code"
},
"gender": {
"order": 9,
"type": "string",
"enum": [
"M",
"F",
"C"
],
"description": "Gender (M=Male, F=Female, C=Corporate)"
},
"last_change_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 30,
"type": [
"string",
"null"
],
"description": "Date of last change to director information (YYYY-MM-DD)"
},
"profession": {
"order": 28,
"type": [
"string",
"null"
],
"description": "Profession or business type"
},
"address_resident": {
"order": 18,
"type": [
"string",
"null"
],
"description": "Address Resident"
},
"local_name": {
"order": 15,
"type": [
"string",
"null"
],
"description": "Local name variant"
},
"reference_id": {
"order": 8,
"type": "string",
"description": "Reference ID"
},
"warranty_amount": {
"order": 35,
"type": [
"string",
"null"
],
"description": "Warranty or guarantee amount"
},
"title": {
"order": 11,
"type": [
"string",
"null"
],
"description": "Title or position"
},
"postcode": {
"order": 21,
"type": [
"string",
"null"
],
"description": "ZIP/Postal code"
},
"start_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 5,
"type": [
"string",
"null"
],
"description": "Start date of involvement"
},
"functions": {
"order": 29,
"items": {
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"function_type"
],
"properties": {
"function_type": {
"type": "string",
"description": "Type of function or role",
"order": 3
},
"function_code": {
"type": "integer",
"description": "Numeric code representing the function type",
"order": 2
},
"record_number": {
"type": "integer",
"description": "Sequential record identifier",
"minimum": 1,
"order": 1
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/function.json",
"title": "Function",
"description": "Director or officer function/role within the company"
},
"type": "array",
"description": "Director functions - can be a single function or array of functions",
"array_ordering": {
"order_fields": [
"record_number",
"function_code",
"function_type"
]
}
},
"origin_city": {
"order": 31,
"type": [
"string",
"null"
],
"description": "Origin"
},
"full_address": {
"order": 21,
"type": [
"string",
"null"
],
"description": "Full Address"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/types/director.json",
"title": "Director",
"description": "Company director or officer"
},
"type": "array",
"description": "Array of Directors",
"array_ordering": {
"order_fields": [
"record_number",
"status",
"entity_type",
"in_capital",
"level",
"start_date",
"end_year",
"end_date",
"start_year",
"entity_id",
"reference_id",
"gender",
"full_name",
"title",
"first_name",
"last_name",
"nickname",
"local_name",
"country",
"city",
"full_address",
"address_line_1",
"address_resident",
"address_line_2",
"address_line_3",
"postcode",
"county",
"country_code",
"email",
"birth_date",
"birth_year",
"died",
"died_date",
"died_year",
"profession",
"functions",
"last_change_date",
"origin",
"signature_code",
"origin_countries",
"origin_city",
"signature_type",
"signature_restriction",
"warranty_currency",
"warranty_amount",
"range_type",
"in_voting_right",
"range_code",
"direct"
]
}
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/management.json",
"title": "Management",
"description": "Entity Management details, Directors, Managers etc"
}
},
"type": "object"
},
"metadata": {
"order": 2,
"properties": {
"language": {
"order": 3,
"type": "string",
"enum": [
"EN",
"MT",
"IT",
"DE",
"FR"
],
"description": "Data language code",
"default": "EN"
},
"extracted_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"order": 1,
"type": "string",
"description": "Date when data was extracted"
}
},
"type": "object",
"description": "Metadata information"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/entity_schema.json",
"description": "Standard Entity Data Schema - Main Entry Point"
}