Attributes

The following fields are currently available:

Field Key

Description

Notes

latest_action

A dictionary consisting of the keys 'action' describing the latest action as a string and 'date' in isoformat.

​

dissolution_date

Date the company was dissolved if applicable.

​

website

Company website URL if known.

​

name

The name we have for this business.

​

dissolution_status

For companies that have been dissolved, their exact status.

See Appendix 1 for possible values.

company_type

A description of the company type, such as private limited company; public limited company, limited liability partnership etc.

​

company_number

The Companies House identification number for the company.

​

company_aims

Description of the sims of the company.

​

legal_status

Detailed legal status of the company.

​

rfa_rating

The Red Flag Alert credit rating currently assigned to this company

A JSON object containing the fields: health_rating_code, credit_limit, short_code, trading_payment_parity, short_description, long_description

tps_registered

Boolean value showing if the company has registered with the Telephone Preference Service.

​

auditor

Name of the company's auditor, if any.

​

incorporation_date

The date of first registration of the Company at Companies House.

​

sic_codes

Array of SIC codes for this company

​

sic_groups

Array of SIC groups for this company

​

sic_group_descriptions

Array of SIC group descriptions for this company

​

sic_divisions

Array of SIC divisions for this company

​

sic_division_descriptions

Array of SIC division descriptions for this company

​

sic_classes

Array of SIC classes for this company

​

sic_class_descriptions

Array of SIC class descriptions for this company

​

sic_sub_classes

Array of SIC sub-classes for this company

​

sic_sections

Array of SIC sections for this company

​

sic_sections_descriptions

Array of SIC section descriptions for this company

​

vat_number

EU formatted tax number if registered for VAT

​

parent_company_number

​

​

employees

If available, number of actual employees

​

estimated_employees

If available, estimated number of employees

​

estimated_turnover

If available, estimated turnover

​

start_date_year

​

(non limited only)

gdpr

​

​

creditor_days

Average time it takes a business to settle its debts with trade suppliers

​

group_id

​

​

type

Currently, always β€˜company’.

This is required by the JSONAPI format.

id

Unique identifier for this business,

For registered companies this will be the Companies House number; for others it will be a unique identifier.