String docs
Site integrations

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
ActionDescriptionListed price
officersSearch 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
appointmentsRead 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/officers

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. 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.
pagesintegerHow 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:

FieldTypeDescription
officerIdstringThe register's officer id, the input to appointments.
urlstringThe officer's appointments page.
namestringAs the register shows it, surname in capitals.
appointmentCountinteger | nullTotal appointments, current and past.
dateOfBirthstring | nullMonth and year of birth as shown, such as May 1980; null for a corporate officer.
descriptionstring | nullThe result's summary line as shown.
addressstring | nullThe officer's latest correspondence address.
matchingNameNotesstring | nullOther 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/appointments

Input

Unknown fields are rejected.

FieldTypeDescription
officerstringRequired. An officer id from officers, such as 0B13jPuAE2FH2Je4VlALAgUJzLI, or the officer's appointments page URL. At most 300 characters.
pagesintegerHow 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:

FieldTypeDescription
officerIdstring—
officerNamestring | nullAs the register shows it.
dateOfBirthstring | nullThe officer's month and year of birth as shown, such as May 1980.
totalAppointmentsinteger | nullThe officer's appointments, all pages.
companyNamestring | null—
companyNumberstring | null—
companyUrlstring | null—
companyStatusstring | nullSuch as Active, Dissolved or Liquidation.
correspondenceAddressstring | null—
rolestring | nullSuch as Director, Secretary or LLP Designated Member.
appointmentStatusstring | nullThe tag beside the role, such as Active or Resigned.
appointedOnstring | nullAs shown, such as 5 November 2024.
appointedBeforestring | nullFor appointments older than the register's records.
notifiedOnstring | nullFor managing officers of overseas entities.
resignedOnstring | null—
ceasedOnstring | null—
nationalitystring | null—
countryOfResidencestring | nullThe register's Place of residence.
occupationstring | null—
identityVerificationDuestring | null—
identityVerificationStatusstring | null—
otherDetailsobject[]Every other labelled value the appointment shows, such as a corporate officer's legal form or registration number.
otherDetails[].labelstring—
otherDetails[].valuestring—

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.