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
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 name | Data type | Description |
|---|---|---|
name | string | Company name |
registered_name | string | Registered name |
registration_date | string | Date of company registration YYYY-MM-DD |
other_trading_names | string | Other trading names for the company |
companies_house_id | string | Companies House ID |
employee_count_range | string | Range for most recent employee count |
last_modified_date | string | Date last modified YYYY-MM-DD |
beauhurst_url | string | Beauhurst platform URL for the company |
website | string | Company website |
tracked_status | string | Tracked or not tracked |
company_status | string | Active, In Administration or Dissolved |
is_sme | boolean | If the company is an SME |
classification object
Classification of the company
| Field name | Data type | Description |
|---|---|---|
sectors | array | List of sectors of the company |
top_level_sector_groups | array | List of top level sector groups |
buzzwords | array | List of buzzwords |
latest_stage_of_evolution | string | Seed, Venture, Growth, Established, Zombie, Excited or Dead |
stage_of_evolution_transitions | array | List of: Primary date in YYYY-MM-DD Stage before Stage after |
description string | string | Description of the company |
tracking_reasons | array | List of tracking reasons |
target_markets | array | List of target markets |
founder_female_percentage | number | Percentage of female founders |
sic_codes | array | List of SIC codes |
actively_hiring | string | Yes, no or unknown |
transactions object
Overview of fundraising and grants
| Field name | Data type | Description |
|---|---|---|
n_fundraisings | integer | Number of fundraisings |
total_amount_fundraisings | integer | Total amount raised in fundraising |
n_grants | integer | Number of grants received |
total_amounts_grants | integer | Total amount of grants received |
latest_valuation | integer | Latest valuation of the company in GBP |
contact_information object
Summary of the company contact information
| Field name | Data type | Description |
|---|---|---|
country | string | Country the company is based in |
lep | string | Local Enterprise Partnership (LEP) |
region | string | UK region |
postcode | string | Company postcode |
address | string | Company address |
emails | string | List of emails for the company |
telephone | string | Company phone number |
key_contacts | array | List of key contacts |
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 name | Data type | Description |
|---|---|---|
people_id | string | Beauhurst People ID |
name | string | Name of key contact |
email | string | Email address of the key contact |
beauhurst_url | string | Beauhurst URL of the key contact |
linkedin_url | string | Key contact LinkedIn URL |
currently_active | boolean | If the contact is currently active |
title | string | Title of the key contact |
job_functions | array | List of job functions |
social_media object
List of social media links
| Field name | Data type | Description |
|---|---|---|
twitter_handle | string | Twitter handle |
instagram_handle | string | Instagram handle |
pinterest_handle | string | Pinterest handle |
facebook_url | string | Facebook URL |
googleplay_url | string | Google Play URL |
itunes_url | string | Itunes URL |
linkedin_url | string | LinkedIn URL |
latest_accounts object
Summary of latest accounts. All financial values are in GBP
| Field name | Data type | Description |
|---|---|---|
year_end_date | string | Date P&L Accounts are made up to YYYY-MM-DD |
turnover | integer | Income earned from normal business activities |
ebitda | integer | Earnings before interest, tax, depreciation and amortisation |
total_assets | integer | Total of fixes and current assets |
number_of_employees | integer | Total number of personnel employed by the company |
cash | integer | Total cash |
total_liabilities | integer | Total long term and current liabilities |
net_assets | integer | Total assets less total liabilities |
research_and_development | integer | R&D expenditure |
export | integer | Direct exports from the country of incorporation |
historic_accounts object
List of historic accounts. All financial values are in GBP
| Field name | Data type | Description |
|---|---|---|
year_end_date | string | Date P&L Accounts are made up to YYYY-MM-DD |
turnover | integer | Income earned from normal business activities |
editda | integer | Earnings before interest, tax, depreciation and amortisation |
total_assets | integer | Total of fixes and current assets |
number_of_employees | integer | Total number of personnel employed by the company |
cash | integer | Total cash |
total_liabilities | integer | Total long term and current liabilities |
net_assets | integer | Total assets less total liabilities |
research_and_development | integer | R&D expenditure |
export | integer | Direct exports from the country of incorporation |