Join Today
Log In
Back to Blog

How to Integrate Companies House API into Your SEIS/EIS Investment Workflow

Quick-start Guide: Integrate Companies House API for Seamless SEIS/EIS Workflows

Imagine having the latest company filings, director details and status updates at your fingertips when evaluating a SEIS or EIS opportunity. Companies House integration makes that possible. No more manual look-ups, no more rattling through PDF reports. Instant data, instant confidence.

In this guide you’ll learn how to register for the Companies House API, configure your development environment, and connect real-time company data directly into your SEIS/EIS investment workflow. You’ll even see how the Oriel IPO Hub streamlines compliance checks and boosts decision-making. Ready to see how Companies House integration can revolutionise investment opportunities in the UK? Explore Companies House integration to revolutionise investment opportunities in the UK

In two clear paragraphs we’ve set the scene. From here you’ll follow step-by-step instructions, troubleshooting tips and advanced use-cases to embed company data into your platform or service. Let’s dive in.

Why Companies House Integration Matters for SEIS/EIS

Understanding SEIS/EIS Requirements

Early-stage tax-relief schemes like SEIS and EIS hinge on eligibility criteria: trading periods, gross assets and active business status. Manually confirming each parameter is time-consuming. That’s where Companies House integration shines:

  • Automatic verification of company incorporation dates
  • Real-time checks on Director and Stakeholder changes
  • Instant status updates (active, dissolved or in liquidation)

Benefits of Real-Time Company Data

Pulling data live means you avoid stale information. Imagine flagging a dissolved business before you commit funds. Or cross-checking Director appointments in seconds. Integration empowers you to:

  • Reduce compliance risk
  • Shorten due-diligence cycles
  • Improve transparency for investors and advisers

All part of building confidence in your investment marketplace.

Getting Started: Register and Configure Your API Access

Requesting an API Key from Companies House

Head to the Companies House Developer Hub and sign up for a key. You’ll need a verified email and basic organisation details. Once approved, note down:

  • Your API key (alpha-numeric string)
  • API endpoint URL (https://api.company-information.service.gov.uk)

Store these safely—ideally in environment variables to avoid accidental leaks.

Setting Up Your Development Environment

Pick your tech stack: Node.js, Python, Ruby or .NET. Ensure you have:

  1. A secure HTTP client library (Axios, requests, Faraday)
  2. JSON parsing capability
  3. Environment variable support

Next, let’s tackle a common Javascript hiccup.

Registering Your JavaScript Domain

If you plan a front-end integration, Companies House restricts CORS to approved domains. A neat trick? Give your local IP a hostname:

  1. Edit /etc/hosts (or Windows’ C:\Windows\System32\drivers\etc\hosts)
  2. Add a line:
    192.168.0.1 my.localdomain
  3. In the CH Developer settings, register my.localdomain as a JavaScript domain

Now your local tests run without CORS errors.

Configuring the Oriel IPO Hub

Within your Oriel IPO Hub subscription, navigate to Integrations > APIs and paste your Companies House key. The Hub then automatically:

  • Manages credential rotation
  • Tracks API usage
  • Displays data retrieval logs

All without a single line of config code on your servers.

Building Your Integration: Step-by-Step

1. Authenticating Requests

Include your API key in the HTTP header:

GET /company/01234567 HTTP/1.1
Host: api.company-information.service.gov.uk
Authorization: YOUR_API_KEY

Most client libraries let you set a default header. Do it once, use it everywhere.

2. Fetching Company Profile

A simple GET request retrieves the essentials:

GET /company/01234567

Response fields to note:

  • company_name
  • company_number
  • status
  • date_of_creation

Store these in your database or pass them straight into your SEIS/EIS eligibility module.

3. Parsing and Storing Results

Use a lightweight ORM or plain objects. Example in JavaScript:

const profile = await client.get(`/company/${companyNumber}`);
const companyData = {
  name: profile.company_name,
  number: profile.company_number,
  status: profile.status,
  incorporationDate: profile.date_of_creation,
};
saveToDatabase(companyData);

Voila: company profiles at your fingertips.

4. Embedding into Your SEIS/EIS Workflow

Link the fetched data to your investor portal. On the Oriel IPO Hub you can:

  • Auto-populate application forms
  • Flag non-eligible companies before submission
  • Present a compliance checklist with one click

Combine this with your due diligence, and you’ve cut hours of admin to minutes.

About halfway through, time to revisit our core promise. See how Companies House integration can revolutionise investment opportunities in the UK in your very own workflow? Transform your investment workflow with Companies House integration and revolutionise investment opportunities in the UK

Handling Errors and Common Pitfalls

API Rate Limits and Retrying

Companies House allows 600 requests per 5 minutes. Plan your calls:

  • Cache frequent lookups
  • Use exponential back-off on 429 responses
  • Bulk-fetch if you need multiple records at once

Troubleshooting CORS and Domain Issues

Remember the /etc/hosts trick? It solves most local domain errors. Beyond that:

  • Ensure HTTP vs HTTPS matches your registered domain
  • Check for stray trailing slashes in your domain entries

Little things can trip you up.

Advanced Use Cases

Pre-Screening Eligible Startups

Build a filter:
– date_of_creation > 2 years?
– Gross assets < £15 million?
– Active status = ‘active’

Auto-flag companies ready for SEIS or EIS.

Learn about SEIS opportunities and embed this filter for your entrepreneur clients to speed up applications.

Enriching Pitch Materials

Fetch director and filing history to enrich investment decks. Give investors real context—who’s behind the company, any recent name changes, even charge filings.

Explore EIS opportunities with confidence when you bring rich data into your pitch.

Integrating with Third-Party Tools

You might feed company data into Slack alerts, Teams channels or CRM systems. Use webhooks in the Oriel IPO Hub to trigger notifications whenever a new eligible firm appears.

Partnering and Scaling

Whether you’re an accountant guiding clients or an angel syndicate sourcing deals, Companies House integration scales with you. Plug in once, benefit forever:

  • Reduce manual checks across portfolios
  • Ensure consistent compliance across adviser networks
  • Leverage Oriel IPO’s commission-free, subscription model

Discover startup opportunities faster with vetted data at every step.

Wrapping Up and Next Steps

You’ve seen how to:

  • Register and configure your API key
  • Handle CORS and domain settings
  • Fetch, parse and embed company data
  • Build filters for SEIS/EIS eligibility

Now it’s time to put it all into action. Log into the Oriel IPO Hub, connect your Companies House credentials and streamline your SEIS/EIS investment process today. See how Companies House integration revolutionises investment opportunities in the UK

Hungry for more?
– If you’re a startup, Raise startup investment with direct access to angel investors.
– If you advise clients, Support your investor clients through every tax relief twist.
– Ready to dive deeper? Access the Oriel IPO Hub and start building your integration now.

Happy coding and investing!

more from this section