How to integrate Companies House into a decision engine

Published on: 2024-08-10 18:48:28

Companies House in the UK provides an API service that works well for checking the status of UK-registered businesses. This information can support credit scoring for micro-businesses and SMEs when issuing loans.

1.

Get an account API key from Companies House

  • Go to Companies House and sign in to your account, or register for one.

    https://find-and-update.company-information.service.gov.uk/
  • Once your account is ready, go to the Developer Hub. In Application Overview, create an application.
    Companies house Developer Hub Dashboard
  • After you create the application, open it and go to “Keys for this application”. Click Create new key to generate the API key.
    Companies house Developer Hub Dashboard
    Fill in the Key name and Key description, then select REST. Leave Restricted IPs and JavaScript empty.
    Companies house Developer Hub Dashboard
  • Confirm that the Key Type for the key you created is “REST API Key”. Copy the API key and keep it for setup in the decision engine.
    Companies house Developer Hub Dashboard
2.

Create a data source in Decisimo Portal

  • Open Data sources, click new, and create one from a template.
    Companies House Dashboard
    Create Companies House from template
  • In the data source definition, switch HTTP Authentication to “YES” and enter the authentication details. Paste the API key from Companies House into “Authentication Username”. Leave HTTP Password empty.
    Create Companies House from template
  • Companies House requires the company number as an input parameter. If you use the Companies House data source template, that definition is already included.
3.

Add Companies House data source to your decision flow

  • If you already have a decision step for data sources, add the Companies House call in that same step. The decision engine calls all sources in the same step in parallel. That keeps execution time low.
  • If you do not yet have a decision flow step for external data, add one. Connect the step, then double-click to open the definition window. In the step, define which attributes from your data object should be sent to the Companies House API.
  • Companies House within a decision step
GO

Run the decision making

  • Release your decision flow, deploy it to an endpoint, and start making decisions with data from Companies House.
Check other data source guides
Decisimo decision engine

Try our decision engine.

Related Articles

  • How to integrate Ekata Address Risk API into a decision engine

    This article shows how to connect Ekata Address Risk API to a decision engine in Decisimo. It covers API key setup, data source configuration, and how to add the call to a decision flow so address checks run as part of decision logic.

  • How to integrate Maxmind minFraud Insights into a decision engine - Decisimo

    This guide shows how to integrate Maxmind minFraud Insights into your decision engine. It covers account setup, license key generation, HTTP authentication in the Decisimo portal, attribute mapping, and decision flow deployment. Follow these steps to call minFraud in parallel with other data sources, so your decision logic can evaluate IP data and risk scores quickly at runtime.

  • How to detect Google Suite hosted email address

    This article explains how to detect Google Suite-hosted email addresses by checking DNS MX records, and why public data cannot reliably show whether an account is a paid G Suite instance or a legacy free Google Apps account. It then shows how to query MX records through a DNS API and implement the check in Decisimo with a sample data object, data source, and decision flow.

  • How to integrate FraudlabsPro into a decision engine

    This guide shows how to connect FraudLabsPro to Decisimo and use it inside your decision logic for eCommerce transaction evaluation. It walks through setup, required API details, and the data fields that help you review, approve, or reject transactions with clearer traceability.

  • How to integrate Maxmind minFraud Factors into a decision engine

    Integrate Maxmind minFraud Factors into Decisimo decision logic. Create a Maxmind account and generate an API key. Then configure an authenticated Maxmind data source in the Decisimo portal, add it to your decision flow, and deploy it to evaluate IP and overall risk scores.