Introduction

Welcome to the Beauhurst API

The Beauhurst API lets you pull Beauhurst data on private companies and people into your own systems. It is a read-only RESTful service built to retrieve data from the Beauhurst platform that you need.


Beauhurst data

All of the Beauhurst API endpoints allow a GET request, allowing you to retrieve data from the Beauhurst platform and use it in the applications needed in your workflow. They do not support the ability to update or create data back into the Beauhurst platform.

Through the API you can access Beauhurst datasets. These have two main data models when looking at companies:

True Companies: True Companies is Beauhurst's way of representing real-world businesses; consolidating data from across legal entities, official registers, IP and innovation databases, public funding databases, news sources, company websites and more into one coherent, comprehensive profile.

Legal entities: Use the Legal Entity APIs when you want the as-filed registry level data.

You can find the right company through their name, registration number website or through a collection created on the Beauhurst platform. Collections are lists of entities that can be made to automatically add new entities that meet specified criteria or can be a static list. True Company and Person collections are accessible through the API.

Data
True CompanySearch
Summary (including location, classification and
Financials
Fundraisings
Grants
Acquisitions
Patents
Charges & mortgages
Key people
Directors
Shareholders
Corporate structure
Legal EntitySearch
Summary
Financials
Directors
Corporate strucure
PersonSearch
Summary (including their key positions, directorships, shareholdings)
Contact details
CollectionsFind your subscription's saved collections and the True Companies or People in each

Getting started

  1. Find your API key in the API settings on the platform. You will need to be an admin to access your API keys. If you don't have access, get in touch with your Account Manager who will be able to help.
  2. Add an Authorization header with the value APIkey followed by your key

Example: find a True Company by name

curl --request GET \
  --url 'https://platform.beauhurst.com/_api/v2.0/truecompany/search?name=Beauhurst' \
  --header 'Authorization: APIkey YOUR_API_KEY' \
  --header 'accept: application/json'


The response contains a meta object which tells you how many results there are, and a results list. Each result includes a true_company_id, which you then use to request that company's financials, fundraisings, key people and other data.

{
  "meta": { "total": 1, "limit": 10, "offset": 0, "count": 1 },
  "results": [
    { "true_company_id": "EXAMPLEID", "name": "Beauhurst", "country": "gb" }
  ]
}

Requests and responses

All requests are GET requests. Most list and search endpoints support the same options:

  • Pagination - Results come back in pages. Use limit to set how many results you get per page and offset to choose where the page starts. The meta object tells you the total number of results.
  • Sorting - Use sort with a field name, such as name or last_modified_date. Add - in front for descending order, for example -last_modified_date.

Versions

Our latest version is v2 - https://platform.beauhurst.com/_api/v2.0/. This uses our new True Company datasets. If you are using v1 and our legacy companies please migrate to the new version to get the latest data and continue to keep your integration aligned with the platform.

Support and resources

If you have any questions or suggestions regarding the APIs please contact our API Product Manager on [email protected]

The standard FAQs on the platform can be found here but if you have any further questions regarding the platform or your subscription please contact your Account Manager