FirstLink API Products Documentation
Entity Reports
Entity Confirmation
Confirms the legal existence of a company through official registry checks. Ideal for quick, early-stage screening when onboarding new clients. Online Instant.
{
"$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"
]
}
},
"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"
}
},
"type": "object",
"$id": "https://firstlink.world/schemas/sections/attributes.json",
"title": "Attributes",
"description": "Legal forms, company statuses, and other legal classifications"
},
"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"
]
}
}
},
"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"
}