Companies House
The UK Companies House register's officers: search officers (directors, secretaries, LLP members, persons with significant control are not included) by name, with appointment count, birth month and year and address; and every appointment an officer holds or held, with company name, number and status, role, appointed and resigned dates, nationality, country of residence and correspondence address.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
companieshouse - Version:
1.0.0 - Reads from:
find-and-update.company-information.service.gov.uk
| Action | Description | Listed price |
|---|---|---|
officers | Search UK Companies House officers (directors, secretaries, LLP members) by name, optionally narrowed by location. Each row is one officer record: id, name, total appointments, birth month and year, and latest correspondence address. 20 a page. Read an officer's appointments with appointments. | Billed per request at your plan's rates |
appointments | Read a UK Companies House officer's appointments, by officer id or page URL: one row per company appointment, current and resigned, with the officer's name, birth month and year and total, and the company name, number and status, role, appointed, resigned or ceased dates, nationality, country of residence and correspondence address as the register shows them. 35 a page. | Billed per request at your plan's rates |
officers
Search UK Companies House officers (directors, secretaries, LLP members) by name, optionally narrowed by location. Each row is one officer record: id, name, total appointments, birth month and year, and latest correspondence address. 20 a page. Read an officer's appointments with appointments.
POST https://request.usestring.ai/v1/integrations/companieshouse/officersInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. An officer's name, such as Rishi Sunak; add location:"London" or location:"CF14" to narrow by address. At least 2 characters. At most 200 characters. |
pages | integer | How many pages of 20 officers to read, from 1. From 1 to 10. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
officerId | string | The register's officer id, the input to appointments. |
url | string | The officer's appointments page. |
name | string | As the register shows it, surname in capitals. |
appointmentCount | integer | null | Total appointments, current and past. |
dateOfBirth | string | null | Month and year of birth as shown, such as May 1980; null for a corporate officer. |
description | string | null | The result's summary line as shown. |
address | string | null | The officer's latest correspondence address. |
matchingNameNotes | string | null | Other appointment names that matched the search, when the register lists them. |
Example
curl https://request.usestring.ai/v1/integrations/companieshouse/officers \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Rishi Sunak"
}'data starts with these rows:
[
{
"officerId": "0B13jPuAE2FH2Je4VlALAgUJzLI",
"url": "https://find-and-update.company-information.service.gov.uk/officers/0B13jPuAE2FH2Je4VlALAgUJzLI/appointments",
"name": "Rishi SUNAK",
"appointmentCount": 2,
"dateOfBirth": "May 1980",
"description": "Total number of appointments 2 - Born May 1980",
"address": "45 Gresham Street, London, United Kingdom, EC2V 7BG",
"matchingNameNotes": null
}
]Requests and billing
- Requests: 1–2 Web Access requests per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
appointments
Read a UK Companies House officer's appointments, by officer id or page URL: one row per company appointment, current and resigned, with the officer's name, birth month and year and total, and the company name, number and status, role, appointed, resigned or ceased dates, nationality, country of residence and correspondence address as the register shows them. 35 a page.
POST https://request.usestring.ai/v1/integrations/companieshouse/appointmentsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
officer | string | Required. An officer id from officers, such as 0B13jPuAE2FH2Je4VlALAgUJzLI, or the officer's appointments page URL. At most 300 characters. |
pages | integer | How many pages of 35 appointments to read, from 1. From 1 to 10. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
officerId | string | — |
officerName | string | null | As the register shows it. |
dateOfBirth | string | null | The officer's month and year of birth as shown, such as May 1980. |
totalAppointments | integer | null | The officer's appointments, all pages. |
companyName | string | null | — |
companyNumber | string | null | — |
companyUrl | string | null | — |
companyStatus | string | null | Such as Active, Dissolved or Liquidation. |
correspondenceAddress | string | null | — |
role | string | null | Such as Director, Secretary or LLP Designated Member. |
appointmentStatus | string | null | The tag beside the role, such as Active or Resigned. |
appointedOn | string | null | As shown, such as 5 November 2024. |
appointedBefore | string | null | For appointments older than the register's records. |
notifiedOn | string | null | For managing officers of overseas entities. |
resignedOn | string | null | — |
ceasedOn | string | null | — |
nationality | string | null | — |
countryOfResidence | string | null | The register's Place of residence. |
occupation | string | null | — |
identityVerificationDue | string | null | — |
identityVerificationStatus | string | null | — |
otherDetails | object[] | Every other labelled value the appointment shows, such as a corporate officer's legal form or registration number. |
otherDetails[].label | string | — |
otherDetails[].value | string | — |
Example
curl https://request.usestring.ai/v1/integrations/companieshouse/appointments \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"officer": "0B13jPuAE2FH2Je4VlALAgUJzLI"
}'data starts with these rows:
[
{
"officerId": "0B13jPuAE2FH2Je4VlALAgUJzLI",
"officerName": "Rishi SUNAK",
"dateOfBirth": "May 1980",
"totalAppointments": 2,
"companyName": "THE OFFICE OF AKSHATA MURTY AND RISHI SUNAK",
"companyNumber": "16062636",
"companyUrl": "https://find-and-update.company-information.service.gov.uk/company/16062636",
"companyStatus": "Active",
"correspondenceAddress": "45 Gresham Street, London, United Kingdom, EC2V 7BG",
"role": "Director",
"appointmentStatus": "Active",
"appointedOn": "5 November 2024",
"appointedBefore": null,
"notifiedOn": null,
"resignedOn": null,
"ceasedOn": null,
"nationality": "British",
"countryOfResidence": "United Kingdom",
"occupation": null,
"identityVerificationDue": "18 November 2026",
"identityVerificationStatus": null,
"otherDetails": []
}
]Requests and billing
- Requests: 1–2 Web Access requests per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
Oregon CCB Licenses
Every active Oregon Construction Contractors Board license: search by business or responsible managing individual's name, license number, type, city or ZIP, with endorsement, first registration and expiry dates, bond and insurance carriers, amounts and expiry dates, address, phone and county.
NPPES NPI Registry
The CMS NPPES NPI Registry of every US healthcare practitioner and organization with an NPI: search by name, NPI, city, state, ZIP or specialty, with credential, practice and mailing addresses and phone numbers, specialties with state license numbers, other names, enumeration and update dates, and an organization's authorized official.