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 protected] |
| 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
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
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
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
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
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
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
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
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
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
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
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
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
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 |