Docs
The Index Point API
Use your key to call the API from your server. Public records are read-only; the watch endpoints let you manage your company list. Company data only, never people.
Getting started
Send requests to https://api.indexpoint.uk using the /v1 paths below. Send your key as Authorization: Bearer <key>. GET /v1/health needs no key.
curl 'https://api.indexpoint.uk/v1/companies/search?q=acme' \
-H "Authorization: Bearer $INDEX_POINT_KEY"
Company data responses are JSON and include as_of, source and licence. Use these fields to show the date and source of the data and its licence.
Keep the key on your server, as a secret in your hosting. Never put it in a web page or an app a visitor can open.
Keys and plans
Each client has its own key and a set of plans. A call outside your plans answers 403.
| Plan | Gives you |
|---|---|
payments | Company search, payment practices reports, payment benchmarks |
live | Live company lookup, search across the whole register, changes |
accounts | Benchmarks from filed accounts |
group | Corporate owners, the chain to the top parent, subsidiaries |
rates | Small business lending rate, exchange rates |
signals | Health signals for one company |
watch | Watch lists and recorded changes, with a morning digest when email delivery is set up |
contracts | Public sector contract awards for one company |
Companies
Search
GET /v1/companies/search?q=acme returns up to 8 companies that have filed payment practices reports. Two characters or more; a company number works too.
GET /v1/companies/search?q=acme&all=1 searches the full register by name prefix or company number and returns up to 8 results in name order. Requires live or payments.
Payment practices
GET /v1/companies/{number}/payments returns the company's basics, its latest report, up to 20 past reports, and the benchmark for its industry in the same year (its SIC division, or section, or all companies when the group is too small). Requires payments.
Benchmarks
GET /v1/benchmarks?group=s-C&metric=days&year=2025 returns medians and quartiles from payment practices reports. year is the year the reporting period ends. Each group needs at least 30 reports. Requires payments.
group:all, a SIC sections-Atos-U, or a divisiond-01tod-99metric:days(average days to pay),pct_lateorpct30(share paid within 30 days)
GET /v1/benchmarks?dataset=accounts&group=s-C&metric=debtor_days returns medians and quartiles from the filed accounts of companies with 10 or more staff. metric is debtor_days, stock_days, creditor_days, gross_margin (per cent), turnover_per_employee (pounds) or turnover_growth (per cent change from the previous accounting period). Each group needs at least 30 qualifying sets of accounts for a metric and year. Values kept: 0 to 365 days, gross margin from -100% to 100%, turnover per employee up to £20 million, turnover change from -90% to 500%. Needs accounts.
Live lookup
GET /v1/companies/{number}/live returns the company's current Companies House profile, its outstanding charges (lenders are named only when they are organisations), the latest accounts figures with debtor, stock and creditor days when the accounts are machine-readable, the latest insolvency notices, and filing_record: the latest strike-off action found and its status, the year end and filing date of each set of accounts found in the past five years (first accounts left out), up to 10 registered office change dates in that time, and up to five previous names. Answers are cached for 24 hours. Needs live.
A successful response also includes these three fields. Each is null when we hold no data for the company.
vehicle_operator: up to 20 goods and passenger vehicle operator licences in Great Britain, most vehicles first, with totals of vehicles and trailers authorised and operating centres across the licences returned. Updated monthly.public_contracts: a summary of the company's public sector contract awards and the five most recent. Cancelled awards are left out. Updated daily.trade: for imports and exports separately, the number of months HMRC listed the company, the first and latest of those months, and up to eight types of goods, most frequent first. A direction isnullwhen the company was never listed for it. HMRC's lists give no values. Updated monthly.
Health signals
GET /v1/companies/{number}/signals returns facts about company status, filing deadlines, insolvency, secured lending, accounts and group structure. Supplier payment facts are available for companies that file payment practices reports. When the live lookup holds vehicle operator licences, public contracts or trade for the company, the answer adds an operator, contracts or trade check. Some facts have no date (date is null). Secured lending covers outstanding charges and charges created or satisfied in the past 12 months. Each fact has a notable flag. There is no score. Requires signals.
Group structure
GET /v1/companies/{number}/group returns owners that are companies, the chain of majority owners up to the top parent, and up to 100 subsidiaries. Individual owners are never included. Needs group.
Public contracts
GET /v1/companies/{number}/contracts?limit=50 returns the company's public sector contract awards, newest first, with a summary. The default limit is 50 and the maximum 100. Each award has buyer, title, value, currency, awarded, status and a url for the notice. value and currency are null when the notice gives none. The list can include cancelled awards; the summary leaves them out. Needs contracts.
Awards come from Find a Tender award notices. A supplier is linked to a company by the Companies House number in the notice, or otherwise by its name (ignoring case, punctuation and the legal form, such as Ltd) and its registered office postcode, when exactly one active company fits (or, if none is active, exactly one other company). When several suppliers share an award, such as a framework, value_shared is true and value is the whole award's figure. value_single_supplier_gbp in the summary totals only awards in pounds with a single supplier, and is null when there are none.
Changes and watch
GET /v1/changes?type=charges&since=2026-11-20§ion=F returns the newest 100 charges (or type=insolvency cases) seen since a date, optionally for one SIC section. Needs live.
With watch, you keep a list of companies:
POST /v1/watchwith{"companies":[{"number":"01234567","label":"..."}]}adds themGET /v1/watchlists them;DELETE /v1/watch/{number}removes oneGET /v1/watch/changes?since=2026-11-20lists what changed: notices, cases, charges, status and overdue filing, and new accounts
Watch checks for changes every 10 minutes. The default list limit is 500 companies. When email delivery is set up for your account, a digest goes to your chosen address at 07:30 UTC.
Sectors and rates
GET /v1/sectors returns SIC 2007 sections and divisions, for industry dropdowns. Any active key.
GET /v1/rates/sme returns the latest Bank of England effective rate on new loans to small and medium businesses. GET /v1/rates/fx returns ECB reference rates as units per £1. Needs rates.
Errors and limits
| Status | Meaning |
|---|---|
401 | Missing or unknown key |
403 | Client account suspended, or the key lacks the plan the call needs |
404 | Unknown company |
429 | A rate limit or daily quota was reached. Each key allows 120 calls a minute. The default daily quota is 5,000 calls per client. |
Live lookups and health signals share a limit of 20 lookups a minute across all clients. Retrying after a minute helps with a per-minute limit. If the daily quota is used up, wait for it to reset.
Sources and licences
- Payment practices reports: Department for Business and Trade
- Company register, accounts, persons with significant control (company owners only), charges and insolvency: Companies House
- Insolvency notices: The Gazette
- Lending rate: Bank of England. Exchange rates: European Central Bank
- Vehicle operator licences: Traffic Commissioners, published by DVSA
- Public contracts: Find a Tender service, Cabinet Office (notices based on the TED schema, © European Union)
- Importers and exporters: HMRC, UK Trade Info
Contains public sector information licensed under the Open Government Licence v3.0. If your tool shows our data, show the credit in each answer's licence field.
Need a key, or a dataset that isn't here? Ask about access.