API Reference

Release notes

Recent updates and improvements to the API

Charges data added to the Companies API

30th May 2025

You can now access charges and mortgages data through the Companies API including the total number of charges, the number of outstanding charges and number of satisfied charges.

{
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "count": 1
  },
  "results": [
    {
      "id": "wfe2fh",
      "charges_and_mortgages": {
        "total_number_of_charges": 32,
        "number_of_outstanding_charges": 3,
        "number_of_satisfied_charges": 29
      }
    }
  ]
}

Request multiple company IDs in the News API

30th May 2025

The Company News API has been updated so that you can now get news on a group of companies rather than needing to request one at a time making it easier to get news updates on the companies you are interested in.

You can now use the query parameter company_idsand use an array of IDs to return news on all of these companies.


Sort and filter by the date a company was added to a collection

22nd May 2025

We have adde mored options to find companies that have recently been added to your collection using the Companies Search.

You can now filter the results by added_to_collection_sinceto find companies added since the date you are interested in.

You can also sort the results from the Companies Search by using added_to_collection_datein the sort parameter.

Both of these options require a collection ID to be included in the request.


Corporate structure added to the Companies API

12th March 2025

We have added more data to show the corporate structure of a company, including their immediate and ultimate parent companies and all of the child companies.

An example response:

{
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "count": 1
  },
  "results": [
    {
      "id": "11567840",
      "corporate_structure": {
        "ultimate_parent": {
          "name": "Revolut Group Holdings Ltd",
          "companies_house_id": "12743269",
          "country": "gb"
        },
        "immediate_parent": {
          "name": "Revolut Ltd",
          "companies_house_id": "08804411",
          "country": "gb"
        },
        "all_children": [
          {
            "name": "Revolut Trading Nominees Ltd",
            "companies_house_id": "13438707",
            "country": "gb"
          }
        ]
      }
    }
  ]
}

Credit limit added to the Companies API

20th February 2025

We have added the latest credit rating and limit to the Companies API within a new credit_rating object.

An example response:

{
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "count": 1
  },
  "results": [
    {
      "id": "tbmx6e",
      "credit_rating": {
        "latest_credit_rating": 29,
        "credit_limit_gbp": 500
      }
    }
  ]
}

Operating profit added to the Companies API

18th December 2024

We have added the operating profit to the financial summary available in the Companies API. This will be included in the latest and five most recent historical accounts returned.

operating_profitis a new field you can now include in your request for example:

  "results": [
    {
      "id": "x8x47k",
      "basic": {
        "name": "Exponential-e"
      },
      "latest_accounts": {
        "year_end_date": "2024-01-31",
        "turnover": 236794000,
        "operating_profit": 24406000
      },
      "historic_accounts": [
        {
          "year_end_date": "2024-01-31",
          "turnover": 236794000,
          "operating_profit": 24406000
        },
        {
          "year_end_date": "2023-01-31",
          "turnover": 206599000,
          "operating_profit": 22030000
        },
        {
          "year_end_date": "2022-01-31",
          "turnover": 184057000,
          "operating_profit": 21476000
        },
        {
          "year_end_date": "2021-01-31",
          "turnover": 170086000,
          "operating_profit": 28982000
        },
        {
          "year_end_date": "2020-01-31",
          "turnover": 142468000,
          "operating_profit": 23570000
        }
      ]
    }
  ]

Search for people by email address

6th December 2024

You can now search for people through the People API by their email address. This will let you find and enrich data on people that you know.

We have added a new email parameter to the request where you can search over a list of email addresses.


New Investor IDs in Transactions API

7th May 2024

Through the Transactions API we returned a list of the investor names involved in a fundraising.

We have now added a new field investors which returns a list of our internal IDs for the investor along with the investor name to enable you to attribute investments to the same fund.

An example response:

 "results": [
    {
      "id": "m64ci3",
      "name": "Skyverse",
      "companies_house_id": "12928805",
      "fundraisings": [
        {
          "id": "hge4",
          "date_raised": "2024-05-08",
          "amount_raised_gbp": 171171,
          "stage_of_evolution_at_date_raised": "Seed",
          "beauhurst_url": "https://platform.beauhurst.com/transaction/fundraising/hge4/",
          "valuation_gbp": 4996435,
          "valuation_confidence": "High",
          "is_announced": true,
          "purposes_of_funding": [],
          "types_of_funding": [
            "Equity"
          ],
          "investor_names": [
            "South East Angels"
          ],
          "investors": [
            {
              "id": "r35w",
              "name": "South East Angels"
            }
          ],
          "stake_taken_percentage": "3.4"
        }


Industries added, Buzzwords improved

24th April 2024

We have added our new industry classifications to the Company API!

You may have seen on our platform we have recently launched industries improving the quality, scale and relevance of company classifications. You can now access these through the API. If you want more information on the industry classifications please reach out to your Account Manager.

Two new fields have been added to the Company API which you can now request:

industriesA list of industries for the company

top_level_industry_groups A list of top level groups for the industries the company is in

An example response:

"results": [
    {
      "id": "yrt8hp",
      "basic": {
        "name": "Quantexa"
      },
      "classification": {
        "industries": [
          "Application software",
          "Data provision and analysis",
          "Risk and compliance"
        ],
        "top_level_industry_groups": [
          "Information technology, telecommunications and data",
          "Safety and security",
          "Software"
        ]

These won't be directly replacing our previous sectors so those will continue working with this new release but we recommend moving over to using industries for better data coverage.

Alongside this we have improved our buzzwords, making them available over a larger number of companies and updating some classifications. This update will come through automatically through the buzzword field in the Company API.