API Reference

View the most important details of all companies on our platform

🚀

The Companies API gives a high-level view of a company's location, size and sector alongside many other key data points, such as contact details and recent accounts

Key details

  • Use your Beauhurst API Key to authorise your request
  • Use a list of Companies House IDs, Beauhurst Company IDs, names, websites or a Collection ID to see details for companies you are interested in
  • Use the 'includes' parameters to select what important information you want to return on the companies
  • Use the modified since parameter to see company data updated after your chosen date

Parameters

sort string

Sort by name, companies_house_id, registration_date or last_modified_date to order the results


limit integer

Number of results to return per page


offset integer

The initial index from which to return the results


company_ids array

Companies House IDs or Beauhurst Company IDs you want to search for


includes array

Include any combination of data values to only return data you want

The Companies Object

id string

Beauhurst Company ID


basic object

Basic details of the company

Field nameData typeDescription
namestringCompany name
registered_namestringRegistered name
registration_datestringDate of company registration YYYY-MM-DD
other_trading_namesstringOther trading names for the company
companies_house_idstringCompanies House ID
employee_count_rangestringRange for most recent employee count
last_modified_datestringDate last modified YYYY-MM-DD
beauhurst_urlstringBeauhurst platform URL for the company
websitestringCompany website
tracked_statusstringTracked or not tracked
started_tracking_atstringDate when tracking started YYYY-MM-DD
company_statusstringActive, In Administration or Dissolved
is_smebooleanIf the company is an SME
cessation_datestringCessation date YYYY-MM-DD
ultimate_parent_companyarray of stringsName and Companies House ID of the ultimate parent company

classification object

Classification of the company

Field nameData typeDescription
industriesarray of stringsList of industries of the company
top_level_industry_groupsarray of stringsList of top level industry groups
sectors array of stringsList of sectors of the company
top_level_sector_groups array of stringsList of top level sector groups
buzzwords array of stringsList of buzzwords
latest_stage_of_evolution stringSeed, Venture, Growth, Established, Zombie, Exited or Dead
stage_of_evolution_transitions array of stringsList of:
Primary date in YYYY-MM-DD
Stage before
Stage after
description stringstringDescription of the company
tracking_reasons array of stringsList of tracking reasons
target_markets array of stringsList of target markets
founder_female_percentage numberPercentage of female founders
sic_codes array of stringsList of SIC codes
actively_hiring stringYes, no or unknown
legal_formstringLegal form of the company
signalsarray of stringsList of growth, innovation, environmental and social & governance signals

transactions object

Overview of fundraising and grants

Field nameData typeDescription
n_fundraisingsintegerNumber of fundraisings
total_amount_fundraisingsintegerTotal amount raised in fundraising
n_grantsintegerNumber of grants received
total_amount_grantsintegerTotal amount of grants received
latest_valuationintegerLatest valuation of the company in GBP

contact_information object

Summary of the company contact information.

This will include the head office address of the company where known, otherwise the registered address.

Field nameData typeDescription
countrystringCountry the company is based in
lepstringLocal Enterprise Partnership (LEP)
regionstringUK region
postcodestringCompany postcode
addressstringCompany address
emailsstringList of emails for the company
telephonestringCompany phone number
registered_addressarrayRegistered address
key_contactsarrayList of key contacts

registered_address object

Full registered address of the company

Field nameData typeDescription
addressstringRegistered address
countystringRegistered address county
lepstringRegistered address LEP
regionstringRegistered address region
postcodestringRegistered address postcode

key_contacts object

List of information on the key contacts

If you opted to not have contact available through the API you will not be able to see the key_contacts object.

Field nameData typeDescription
people_idstringBeauhurst People ID
namestringName of key contact
emailstringEmail address of the key contact
beauhurst_urlstringBeauhurst URL of the key contact
linkedin_urlstringKey contact LinkedIn URL
currently_activebooleanIf the contact is currently active
titlestringTitle of the key contact
job_functionsarray of stringsList of job functions

directors object

List of current and previous directors

Field nameData typeDescription
people_idstringBeauhurst People ID
namestringName of the director
emailstringEmail address of the director
from_datestringDate directorship started
until_datestringDate directorship ended
currently_activebooleanIf the director is currently active

social_media object

List of social media links

Field nameData typeDescription
twitter_handlestringTwitter handle
instagram_handlestringInstagram handle
pinterest_handlestringPinterest handle
facebook_urlstringFacebook URL
googleplay_urlstringGoogle Play URL
itunes_urlstringItunes URL
linkedin_urlstringLinkedIn URL

latest_accounts object

Summary of latest accounts. All financial values are in GBP

Field nameData typeDescription
year_end_datestringDate P&L Accounts are made up to YYYY-MM-DD
turnoverintegerIncome earned from normal business activities
ebitdaintegerEarnings before interest, tax, depreciation and amortisation
total_assetsintegerTotal of fixed and current assets
number_of_employeesintegerTotal number of personnel employed by the company
cashintegerTotal cash
total_liabilitiesintegerTotal long term and current liabilities
net_assetsintegerTotal assets less total liabilities
research_and_developmentintegerR&D expenditure
exportintegerDirect exports from the country of incorporation
auditorstringName of the auditor of the accounts
audit_feesintegerThe amount paid to the auditors for the audit

historic_accounts object

List of historic accounts. All financial values are in GBP

Field nameData typeDescription
year_end_datestringDate P&L Accounts are made up to YYYY-MM-DD
turnoverintegerIncome earned from normal business activities
ebitdaintegerEarnings before interest, tax, depreciation and amortisation
total_assetsintegerTotal of fixed and current assets
number_of_employeesintegerTotal number of personnel employed by the company
cashintegerTotal cash
total_liabilitiesintegerTotal long term and current liabilities
net_assetsintegerTotal assets less total liabilities
research_and_developmentintegerR&D expenditure
exportintegerDirect exports from the country of incorporation
auditorstringName of the auditor of the accounts
audit_feesintegerThe amount paid to the auditors for the audit