Beta

Compdex is new: mistakes will happen. Tell us.

Report a problemSuggest a feature or give feedback
Skip to main content
API and integrations

UK company data, in your own systems.

A REST API and signed webhooks for everything Compdex reads: filings, officers, owners, scores and the estimates small companies leave out. The same payloads our own pages are built from, so a page and your code cannot drift apart.

  • Live now
  • Estimates labelled in the data
  • Team: 5,000 calls a month
curl -H "Authorization: Bearer $COMPDEX_API_KEY" \
  "https://api.compdex.ai/v1/companies/09697233"
200application/jsonSolvi & Heirs Ltd, real figures
{  "apiVersion": "v1",  "company": {    "number": "09697233",    "name": "SOLVI & HEIRS LTD",    "status": "active",    "sicCodes": ["73120", "82990", "96090"]  },  "financials": [    {      "periodEnd": "2025-07-31",      "cash": 253618,      "netAssets": 306219,      "turnover": null    }  ],  "profitEstimate": {    "estimate": true,    "low": 112438,    "high": 226577,    "confidence": 87,    "method": "profit_model",    "modelVersion": "profit-2.3.0"  },  "scores": {    "health": {      "value": 77,      "band": "A"    }  }}
One record, every route

The same company record, built for your code.

Everything keys off the company number. Estimates come back labelled as estimates, with their range, confidence and the model that made them, and a figure a filing did not state is null, never zero.

RecordFiled accounts
RecordOfficers and owners
RecordCharges and notices
EstimateProfit and turnover
Public routesLiveGET/v1/companies/{number}The company recordGET/v1/search?q=Companies and officers by name or numberGET/v1/officers/{id}A person’s appointmentsGET/v1/finderEvery company, filteredGET/v1/sic?q=SIC codes and their descriptionsPUT/v1/watchlist/{number}Your watchlistPOST/v1/lists/{id}/membersYour listsGET/v1/api/usageThis month’s callsA key in the Authorization header. The reference lists every field.
Your appYour CRM
Your appYour credit checks
Your appYour data warehouse
  1. 01Company dataA company’s register facts, filed accounts, estimates, scores, people, control, charges and filings in one response. Search, officers, the finder and SIC codes beside it.
  2. 02Your own workspaceRead and change your watchlist and your lists, so what your code adds shows up in the app the same minute.
  3. 03Keys and allowancesKeys are made on your account and shown once. Every response says how many calls this month has used and how many are left.
Webhooks

Be told the moment the register changes.

Add an endpoint and choose the events, and Compdex posts each one about the companies on your watchlist, signed so you can prove it came from us. A new endpoint carries these unless you choose others.

  • Accounts filedfiling.accounts
  • Confirmation statementfiling.confirmation
  • Director appointedofficer.appointed
  • Director resignedofficer.resigned
  • New chargecharge.created
  • Charge satisfiedcharge.satisfied
  • Gazette noticegazette.notice
  • Score changedscore.changed
  • Signed with HMAC-SHA256 over the timestamp and the body, in the compdex-signature header
  • Retried on a schedule when your endpoint is down, and switched off after 20 failures in a row
  • Every event carries an id to drop a repeat on
  • Up to 5 endpoints an account, each with the events it chose
Every event kind in the reference
SourceThe registerCompdexYour endpoint/hooks/compdex
Event bodyExample
{  "id": "evt…",  "type": "filing.accounts",  "createdAt": "2026-04-08T…",  "company": {    "number": "09697233",    "name": "SOLVI & HEIRS LTD"  },  "event": {    "companyNumber": "09697233",    "occurredOn": "2026-04-08",    "kind": "filing.accounts",    "headline": "Small company accounts",    "sourceUrl": "…"  }}
The event in this body is Solvi & Heirs Ltd’s own, from its filing history; the ids are shortened. The endpoint path is yours to choose.
Integrations

Where you already work.

Zapier for anything with a Zap, and a push to HubSpot or Salesforce for lists and companies, matched on the company number.

ZapierWith TeamAn instant trigger for events on your watchlist, a polling trigger, and actions that add companies to a list or watch them.Shared by invitation while it is in private release.
HubSpotWith TeamLists and single companies as company records, upserted by a company number property you create once. You map each field.
SalesforceWith TeamLists and single companies as Accounts, upserted by an external ID field you create once. You map each field.
HubSpot and Salesforce
  • A value we do not hold is left out, never sent empty
  • Estimates only if you ask, sent as text that says so
  • Lists kept in step every day if you choose
Plans and limits

The API comes with Team and Data.

Reading, scoring and comparing companies in the app stays as it is on every plan. Calls over the month’s allowance are refused until the first of the next month; there is no overage billing.

See what is in each plan
AllowanceFreeProTeamData
API calls a monthNot includedNot included5,000No limit
Requests per keyNot includedNot included120 requests a minute and 5,000 a day300 requests a minute and 100,000 a day
Webhooks on watched companiesNot includedNot includedIncludedIncluded
ZapierNot includedNot includedIncludedIncluded
HubSpot and Salesforce pushNot includedNot includedIncludedIncluded

From the plans table the product enforces.

What the API does not do yet
  • There is no overage billing. Calls over the monthly allowance are refused until the first of the next month.
  • The Zapier integration is shared by invitation while it is in private release.
  • CRM sync sends companies only, not contacts or deals.
  • Lookalike searches, list exports and uploads are not offered to API keys yet.
  • A keyed call reads a company it has not read before, but writes no brief or timeline notes for it; those are written when a person opens the page.
Is the API live?
Yes. Create a key on your account, on a plan that includes the API, and call the routes the reference lists. Webhooks, Zapier and the CRM push are live too.
Which plans include it?
Team: 5,000 calls a month; Data: no monthly cap on calls.
How are calls counted?
Each call counts against the plan’s monthly allowance, shared by everyone on a team. Every response carries how many calls this month has used and the limit. Webhook deliveries are not calls; polling for events is.
Are estimates marked in the data?
Yes. Every estimate carries estimate true, a range, a confidence and a method, and a figure a filing did not state is null, never zero. Parts your plan does not include are left out rather than filled.
How do I know a webhook came from you?
Every delivery is signed with HMAC-SHA256 over the timestamp and the body, using a secret shown once when you add the endpoint. The reference shows how to check it.
Can I get bulk data?
The true-sector dataset, the taxonomy and every company’s classification, is in the API on the Data plan. Risk feeds are delivered on request: write to us and say what you need.

Read any company, free.

The record the API returns is on every company page, free to read.

Or create a free account

Free to readAny company’s brief, estimates, timeline and Compdex Health Score. No card.
Pro from £39 a monthCredit score and lender view, Online visibility recommendations, Watchlists, Alerts by email and Slack.
Questions, or a team to set up?Talk to us