Skip to main content

Data Fields Reference

Complete reference of all data fields available in Companies in the UK MCP.

Company Fields

FieldTypeDescriptionAlways Present
company_numberstring8-character unique IDYes
company_namestringLegal company nameYes
company_statusstringActive, Dissolved, etc.Yes
company_typestringLtd, PLC, LLP, etc.Yes
incorporation_datedateDate of incorporationYes
dissolution_datedateDate dissolvedNo
registered_addressobjectOfficial addressYes
sic_codesarrayIndustry codesUsually
previous_namesarrayHistorical namesNo
accountsobjectFiling datesUsually
confirmation_statementobjectAnnual filingUsually
has_chargesbooleanOutstanding chargesNo
has_insolvency_historybooleanPast insolvencyNo

Financial Fields

FieldTypeDescriptionAvailability
total_assetsnumberAll assetsCommon
current_assetsnumberShort-term assetsCommon
fixed_assetsnumberLong-term assetsCommon
total_liabilitiesnumberAll debtsCommon
current_liabilitiesnumberShort-term debtsCommon
shareholders_fundsnumberEquityCommon
cashnumberCash and equivalentsSometimes
called_up_share_capitalnumberPaid-in capitalSometimes

Officer Fields

FieldTypeDescription
namestringFull name
rolestringDirector, Secretary, etc.
appointed_ondateAppointment date
resigned_ondateResignation date
nationalitystringCountry of nationality
country_of_residencestringResidence country
date_of_birthobjectYear and month
occupationstringProfessional role

Address Fields

FieldTypeDescription
line_1stringFirst line
line_2stringSecond line
townstringTown/city
countystringCounty/region
postcodestringPostal code
countrystringCountry