Companies House (Independent Publisher)

This connector uses the Companies House API to search and retrieve information about companies registered in the UK. Companies House is a UK government organisation that registers companies, recording information about them like their address, annual turnover and who is elected as an officer of the company.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Matt Collins-Jones
URL	https://github.com/MattCollins-Jones
Email	mattcollinsjones@gmail.com

Connector Metadata
Publisher	Matt Collins
Website	https://www.gov.uk/government/organisations/companies-house
Privacy policy	https://www.gov.uk/help/privacy-notice
Categories	Business Management;Website

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Authorization	securestring	The Authorization for this api	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Address By Number	Address By Number
Charges By Company Number	Charges By Company Number
Charges By Number and Charge Id	Charges By Number and Charge Id
Company Officers By Company Number	Company Officers By Company Number
Company Officers By Number and Appointment Id	Company Officers By Number and Appointment Id
Filing History By Company Number	Filing History By Company Number
Filing History By Number and Id	Filing History By Number and Id
Find Company By Number	Find a Company By their Company Number
Individual PSC	Find information about a Person of Significan Control by Company Number and PCS ID
List Person of Significant Control	List Persons of Significant Control by Company Number
List Statements for Person of Significant Control	List Statements for Person of Significant Control by Company Number
Officer Appointment by Officer Id	Officer Appointment by Officer Id
UK Establishments	List of UK-establishments companies

Address By Number

Operation ID:

AddressByNumber

Address By Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
etag	etag	string	Etag
kind	kind	string	Kind
self	links.self	string	Self
address_line_1	address_line_1	string	Address line 1
address_line_2	address_line_2	string	Address line 2
country	country	string	Country
locality	locality	string	Locality
region	region	string	Region
postal_code	postal_code	string	Postal code

Charges By Company Number

Operation ID:

ChargesByNumber

Charges By Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
total_count	total_count	integer	Total count
items	items	array of object	Items
charge_number	items.charge_number	integer	Charge number
self	items.links.self	string	Self
created_on	items.created_on	string	Created on
transactions	items.transactions	array of object	Transactions
filing_type	items.transactions.filing_type	string	Filing type
filing	items.transactions.links.filing	string	Filing
delivered_on	items.transactions.delivered_on	string	Delivered on
etag	items.etag	string	Etag
status	items.status	string	Status
charge_code	items.charge_code	string	Charge code
description	items.classification.description	string	Description
type	items.classification.type	string	Type
description	items.particulars.description	string	Description
contains_fixed_charge	items.particulars.contains_fixed_charge	boolean	Contains fixed charge
floating_charge_covers_all	items.particulars.floating_charge_covers_all	boolean	Floating charge covers all
type	items.particulars.type	string	Type
contains_floating_charge	items.particulars.contains_floating_charge	boolean	Contains floating charge
delivered_on	items.delivered_on	string	Delivered on
persons_entitled	items.persons_entitled	array of object	Persons entitled
name	items.persons_entitled.name	string	Name
satisfied_count	satisfied_count	integer	Satisfied count
unfiltered_count	unfiltered_count	integer	Unfiltered count
part_satisfied_count	part_satisfied_count	integer	Part satisfied count

Charges By Number and Charge Id

Operation ID:

ChargesByNumberAndChargeId

Charges By Number and Charge Id

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number
Charge ID	ChargeId	True	string	Specify the Charge ID

Returns

Name	Path	Type	Description
charge_number	charge_number	integer	Charge number
self	links.self	string	Self
created_on	created_on	string	Created on
transactions	transactions	array of object	Transactions
filing_type	transactions.filing_type	string	Filing type
filing	transactions.links.filing	string	Filing
delivered_on	transactions.delivered_on	string	Delivered on
etag	etag	string	Etag
status	status	string	Status
charge_code	charge_code	string	Charge code
description	classification.description	string	Description
type	classification.type	string	Type
description	particulars.description	string	Description
contains_fixed_charge	particulars.contains_fixed_charge	boolean	Contains fixed charge
floating_charge_covers_all	particulars.floating_charge_covers_all	boolean	Floating charge covers all
type	particulars.type	string	Type
contains_floating_charge	particulars.contains_floating_charge	boolean	Contains floating charge
delivered_on	delivered_on	string	Delivered on
persons_entitled	persons_entitled	array of object	Persons entitled
name	persons_entitled.name	string	Name

Company Officers By Company Number

Operation ID:

CompanyOfficersByNumber

Company Officers By Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
etag	etag	string	Etag
active_count	active_count	integer	Active count
kind	kind	string	Kind
inactive_count	inactive_count	integer	Inactive count
resigned_count	resigned_count	integer	Resigned count
items	items	array of object	Items
appointments	items.links.officer.appointments	string	Appointments
self	items.links.self	string	Self
premises	items.address.premises	string	Premises
locality	items.address.locality	string	Locality
postal_code	items.address.postal_code	string	Postal code
country	items.address.country	string	Country
address_line_1	items.address.address_line_1	string	Address line 1
region	items.address.region	string	Region
address_line_2	items.address.address_line_2	string	Address line 2
name	items.name	string	Name
officer_role	items.officer_role	string	Officer role
appointed_on	items.appointed_on	string	Appointed on
month	items.date_of_birth.month	integer	Month
year	items.date_of_birth.year	integer	Year
country_of_residence	items.country_of_residence	string	Country of residence
occupation	items.occupation	string	Occupation
nationality	items.nationality	string	Nationality
former_names	items.former_names	array of object	Former names
surname	items.former_names.surname	string	Surname
resigned_on	items.resigned_on	string	Resigned on
self	links.self	string	Self
total_results	total_results	integer	Total results
start_index	start_index	integer	Start index
items_per_page	items_per_page	integer	Items per page

Company Officers By Number and Appointment Id

Operation ID:

CompanyOfficersByNumberAndAppointmentId

Company Officers By Number and Appointment Id

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number
Appointment ID	AppointmentId	True	string	Specify the Appointment ID

Returns

Name	Path	Type	Description
self	links.self	string	Self
appointments	links.officer.appointments	string	Appointments
name	name	string	Name
address_line_1	address.address_line_1	string	Address line 1
country	address.country	string	Country
locality	address.locality	string	Locality
postal_code	address.postal_code	string	Postal code
premises	address.premises	string	Premises
appointed_on	appointed_on	string	Appointed on
officer_role	officer_role	string	Officer role

Filing History By Company Number

Operation ID:

FilingHistoryByCompNumber

Filing History By Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
filing_history_status	filing_history_status	string	Filing history status
items_per_page	items_per_page	integer	Items per page
start_index	start_index	integer	Start index
items	items	array of object	Items
action_date	items.action_date	string	Action date
category	items.category	string	Category
date	items.date	string	Date
description	items.description	string	Description
change_date	items.description_values.change_date	string	Change date
new_address	items.description_values.new_address	string	New address
old_address	items.description_values.old_address	string	Old address
made_up_date	items.description_values.made_up_date	string	Made up date
description	items.description_values.description	string	Description
capital	items.description_values.capital	array of object	Capital
figure	items.description_values.capital.figure	string	Figure
currency	items.description_values.capital.currency	string	Currency
date	items.description_values.date	string	Date
officer_name	items.description_values.officer_name	string	Officer name
appointment_date	items.description_values.appointment_date	string	Appointment date
self	items.links.self	string	Self
document_metadata	items.links.document_metadata	string	Document metadata
type	items.type	string	Type
pages	items.pages	integer	Pages
barcode	items.barcode	string	Barcode
transaction_id	items.transaction_id	string	Transaction id
paper_filed	items.paper_filed	boolean	Paper filed
resolutions	items.resolutions	array of object	Resolutions
category	items.resolutions.category	string	Category
description	items.resolutions.description	string	Description
res_type	items.resolutions.description_values.res_type	string	Res type
subcategory	items.resolutions.subcategory	string	Subcategory
type	items.resolutions.type	string	Type
subcategory	items.subcategory	string	Subcategory
total_count	total_count	integer	Total count

Filing History By Number and Id

Operation ID:

FilingHistoryByNumberAndId

Filing History By Number and Id

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number
Transaction ID	TransactionId	True	string	Specify the Transaction ID

Returns

Name	Path	Type	Description
action_date	action_date	string	Action date
category	category	string	Category
date	date	string	Date
description	description	string	Description
change_date	description_values.change_date	string	Change date
new_address	description_values.new_address	string	New address
old_address	description_values.old_address	string	Old address
self	links.self	string	Self
document_metadata	links.document_metadata	string	Document metadata
type	type	string	Type
pages	pages	integer	Pages
barcode	barcode	string	Barcode
transaction_id	transaction_id	string	Transaction id

Find Company By Number

Operation ID:

CompanyByNumber

Find a Company By their Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
jurisdiction	jurisdiction	string	Jurisdiction
has_been_liquidated	has_been_liquidated	boolean	Has been liquidated
postal_code	registered_office_address.postal_code	string	Postal code
address_line_1	registered_office_address.address_line_1	string	Address line 1
region	registered_office_address.region	string	Region
country	registered_office_address.country	string	Country
address_line_2	registered_office_address.address_line_2	string	Address line 2
locality	registered_office_address.locality	string	Locality
date_of_creation	date_of_creation	string	Date of creation
company_name	company_name	string	Company name
day	accounts.accounting_reference_date.day	string	Day
month	accounts.accounting_reference_date.month	string	Month
overdue	accounts.overdue	boolean	Overdue
period_end_on	accounts.last_accounts.period_end_on	string	Period end on
made_up_to	accounts.last_accounts.made_up_to	string	Made up to
type	accounts.last_accounts.type	string	Type
period_start_on	accounts.last_accounts.period_start_on	string	Period start on
next_due	accounts.next_due	string	Next due
period_start_on	accounts.next_accounts.period_start_on	string	Period start on
overdue	accounts.next_accounts.overdue	boolean	Overdue
period_end_on	accounts.next_accounts.period_end_on	string	Period end on
due_on	accounts.next_accounts.due_on	string	Due on
next_made_up_to	accounts.next_made_up_to	string	Next made up to
company_number	company_number	string	Company number
type	type	string	Type
undeliverable_registered_office_address	undeliverable_registered_office_address	boolean	Undeliverable registered office address
sic_codes	sic_codes	array of string	SIC codes
last_full_members_list_date	last_full_members_list_date	string	Last full members list date
has_insolvency_history	has_insolvency_history	boolean	Has insolvency history
etag	etag	string	Etag
has_charges	has_charges	boolean	Has charges
company_status	company_status	string	Company status
last_made_up_to	confirmation_statement.last_made_up_to	string	Last made up to
next_made_up_to	confirmation_statement.next_made_up_to	string	Next made up to
overdue	confirmation_statement.overdue	boolean	Overdue
next_due	confirmation_statement.next_due	string	Next due
self	links.self	string	Self
filing_history	links.filing_history	string	Filing history
officers	links.officers	string	Officers
charges	links.charges	string	Charges
persons_with_significant_control_statements	links.persons_with_significant_control_statements	string	Persons with significant control statements
persons_with_significant_control	links.persons_with_significant_control	string	Persons with significant control
registered_office_is_in_dispute	registered_office_is_in_dispute	boolean	Registered office is in dispute
has_super_secure_pscs	has_super_secure_pscs	boolean	Has super secure pscs
can_file	can_file	boolean	Can file

Individual PSC

Operation ID:

IndividualPsc

Find information about a Person of Significan Control by Company Number and PCS ID

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number
Person with Significant Control ID	PCSId	True	string	Specify the ID of the Person with Significant Control

Returns

Name	Path	Type	Description
name	name	string	Name
natures_of_control	natures_of_control	array of string	Natures of control
kind	kind	string	Kind
forename	name_elements.forename	string	Forename
title	name_elements.title	string	Title
surname	name_elements.surname	string	Surname
month	date_of_birth.month	integer	Month
year	date_of_birth.year	integer	Year
etag	etag	string	Etag
notified_on	notified_on	string	Notified on
self	links.self	string	Self
country	address.country	string	Country
locality	address.locality	string	Locality
premises	address.premises	string	Premises
postal_code	address.postal_code	string	Postal code
nationality	nationality	string	Nationality
country_of_residence	country_of_residence	string	Country of residence

List Person of Significant Control

Operation ID:

ListPsc

List Persons of Significant Control by Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
self	links.self	string	Self
persons_with_significant_control	links.persons_with_significant_control	string	Persons with significant control
total_results	total_results	integer	Total results
ceased_count	ceased_count	integer	Ceased count
start_index	start_index	integer	Start index
active_count	active_count	integer	Active count
items	items	array of object	Items
notified_on	items.notified_on	string	Notified on
statement	items.statement	string	Statement
etag	items.etag	string	Etag
kind	items.kind	string	Kind
self	items.links.self	string	Self
ceased_on	items.ceased_on	string	Ceased on
items_per_page	items_per_page	integer	Items per page

List Statements for Person of Significant Control

Operation ID:

ListStatementsPsc

List Statements for Person of Significant Control by Company Number

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
items	items	array of object	Items
address_line_2	items.address.address_line_2	string	Address line 2
locality	items.address.locality	string	Locality
postal_code	items.address.postal_code	string	Postal code
region	items.address.region	string	Region
country	items.address.country	string	Country
premises	items.address.premises	string	Premises
address_line_1	items.address.address_line_1	string	Address line 1
name	items.name	string	Name
country_of_residence	items.country_of_residence	string	Country of residence
notified_on	items.notified_on	string	Notified on
natures_of_control	items.natures_of_control	array of string	Natures of control
title	items.name_elements.title	string	Title
middle_name	items.name_elements.middle_name	string	Middle name
surname	items.name_elements.surname	string	Surname
forename	items.name_elements.forename	string	Forename
year	items.date_of_birth.year	integer	Year
month	items.date_of_birth.month	integer	Month
nationality	items.nationality	string	Nationality
kind	items.kind	string	Kind
etag	items.etag	string	Etag
self	items.links.self	string	Self
active_count	active_count	integer	Active count
total_results	total_results	integer	Total results
items_per_page	items_per_page	integer	Items per page
ceased_count	ceased_count	integer	Ceased count
self	links.self	string	Self
persons_with_significant_control_statements	links.persons_with_significant_control_statements	string	Persons with significant control statements
start_index	start_index	integer	Start index

Officer Appointment by Officer Id

Operation ID:

OfficerAppointmentByOfficerId

Officer Appointment by Officer Id

Parameters

Name	Key	Required	Type	Description
Officer ID	OfficerId	True	string	Specify the ID of the Officer at the Company

Returns

Name	Path	Type	Description
start_index	start_index	integer	Start index
self	links.self	string	Self
etag	etag	string	Etag
name	name	string	Name
total_results	total_results	integer	Total results
is_corporate_officer	is_corporate_officer	boolean	Is corporate officer
kind	kind	string	Kind
items	items	array of object	Items
officer_role	items.officer_role	string	Officer role
forename	items.name_elements.forename	string	Forename
surname	items.name_elements.surname	string	Surname
title	items.name_elements.title	string	Title
name	items.name	string	Name
company_number	items.appointed_to.company_number	string	Company number
company_name	items.appointed_to.company_name	string	Company name
company_status	items.appointed_to.company_status	string	Company status
company	items.links.company	string	Company
appointed_on	items.appointed_on	string	Appointed on
locality	items.address.locality	string	Locality
address_line_1	items.address.address_line_1	string	Address line 1
postal_code	items.address.postal_code	string	Postal code
premises	items.address.premises	string	Premises
country	items.address.country	string	Country
items_per_page	items_per_page	integer	Items per page

UK Establishments

Operation ID:

UKEstablishments

List of UK-establishments companies

Parameters

Name	Key	Required	Type	Description
Company Number	CompanyNumber	True	string	Specify the Company Number

Returns

Name	Path	Type	Description
etag	etag	string	Etag
items	items	array of object	Items
company_name	items.company_name	string	Company name
company_number	items.company_number	string	Company number
company_status	items.company_status	string	Company status
company	items.links.company	string	Company
locality	items.locality	string	Locality
kind	kind	string	Kind
self	links.self	string	Self