Partilhar via


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

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