Home / API
Every UK PLC, as structured data
The pages on this site are free and always will be. The API sells machine access: the full record of any of the 4,470 public limited companies on the register, or of any of their 63,042 officer ids, as JSON, with the source and date of every field. The same credits open a full record in the browser.
The data used to be a free CSV download. It is now here instead, because the records carry far more than the register file did, and each field now says where it came from and when.
Price
Credits come in packs, because card fees make a lone £1 payment uneconomic: £5 for 5 records, £25 for 25 records, £100 for 100 records, £500 for 500 records. Credits do not expire.
Buy credits
Endpoints
| Request | What it returns | Cost |
|---|---|---|
GET /api/v1/search?q= | Up to 20 companies (by name or number), and how many officer records match a name (officer names are in the paid records) | Free, 30 a minute |
GET /api/v1/company/{number} | The full company record | 1 credit, then free for 12 months |
GET /api/v1/officer/{officer_id} | The full officer record: PLC appointments with roles and dates, and named officers on the same current boards | 1 credit, then free for 12 months |
GET /api/v1/account | Credits left, records unlocked, the last 50 ledger lines | Free |
Send the key as Authorization: Bearer <key>. Each key is limited to 60 requests a minute. Errors come back as JSON with a code: 401 no key, 402 no credits, 404 not found, 429 too fast. The machine-readable specification is the OpenAPI file.
curl -H "Authorization: Bearer YOUR_KEY" https://www.publiclimitedcompany.co.uk/api/v1/company/01142830
What a company record holds
- From the Companies House register: name, status, incorporation, registered office address, SIC codes, age and rank, and the accounts-overdue flag with its caveat.
- Officers: every director and secretary, current and past, with role and appointment and resignation dates, and the board counts. Name, role and dates only.
- FCA National Storage Mechanism: whether it files regulated announcements, and the timeline of announcement types and dates, with results and dividend announcements. Types and dates only; we do not link to NSM documents.
- GLEIF: the LEI, its status and renewal date, the direct and ultimate parent, and subsidiaries with an LEI.
- Companies House accounts: turnover, profit or loss, net assets and employees, as filed, where the accounts were filed in machine-readable form.
- Contracts Finder and Find a Tender: public contract awards, with buyer, value, date and whether it was a framework.
- Electoral Commission: political donations, with amount, date and recipient. Individuals who received donations are not named.
- Wikidata: ticker, ISIN and website, where recorded.
Not included, by design: persons with significant control, charges, insolvency cases, Gazette notices and filing history. No date of birth, address, nationality, residence or occupation is held for any officer.
An example record
The record of 3I GROUP PLC, trimmed to the first few items of each list for display. This one is free to read.
{
"company_number": "01142830",
"record_built": "2026-11-19",
"url": "https://www.publiclimitedcompany.co.uk/company/3i-group-plc-01142830/",
"name": {
"value": "3I GROUP PLC",
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"status": {
"value": "Active",
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"incorporated": {
"value": "1973-11-01",
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"registered_office": {
"value": {
"lines": [
"1 KNIGHTSBRIDGE",
"LONDON",
"SW1X 7LX"
],
"town": "London",
"postcode": "SW1X 7LX",
"country": "UNITED KINGDOM"
},
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"sic_codes": {
"value": [
"64999 - Financial intermediation not elsewhere classified"
],
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"accounts_overdue": {
"value": {
"overdue_on_snapshot": false,
"days_overdue": 0,
"note": "A snapshot: filing resets the due date, and a late filing is not by itself evidence of wrongdoing."
},
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"age": {
"value": {
"years": 53,
"rank_oldest": 535,
"of": 4470
},
"source": "ch_bulk",
"as_at": "2026-11-01"
},
"listing": {
"value": {
"status": "files regulated announcements (in the last 24 months)",
"announcements_total": 726,
"first": "2011-01-31",
"last": "2026-11-17",
"by_type": {
"additional listing": 2,
"admission to trading": 10,
"agm statement": 3,
"annual financial report": 20,
"block listing interim review": 18,
"change of registered office": 1,
"circ re.": 1,
"director declaration": 12,
"director/pdmr shareholding": 263,
"directorate change": 14,
"doc re.": 33,
"final results": 7,
"further re": 1,
"half-year financial report": 26,
"holding(s) in company": 28,
"miscellaneous": 31,
"notice of agm": 18,
"portfolio update": 34,
"proxy form": 7,
"publication of a prospectus": 5,
"publication of a supplementary prospectus": 2,
"result of agm": 26,
"result of tender offer": 1,
"strategy/company/ operations update": 5,
"total voting rights": 117,
"trading statement": 13,
"transaction in own shares": 28
},
"recent": [
{
"date": "2026-11-17",
"type": "Holding(s) in Company"
},
{
"date": "2026-11-16",
"type": "Transaction in Own Shares"
},
{
"date": "2026-11-16",
"type": "Transaction in Own Shares"
}
],
"results": [],
"dividends": [],
"matched_by": "lei"
},
"source": "nsm",
"as_at": "2026-11-19"
},
"lei": {
"value": {
"lei": "35GDVHRBMFE7NWATNM84",
"legal_name": "3I GROUP PLC",
"registration_status": "ISSUED",
"next_renewal": "2026-12-29",
"entity_status": "ACTIVE",
"other_leis": []
},
"source": "gleif",
"as_at": "2026-11-18"
},
"parent": {
"value": null,
"source": "gleif",
"as_at": "2026-11-18"
},
"ultimate_parent": {
"value": null,
"source": "gleif",
"as_at": "2026-11-18"
},
"direct_subsidiaries_with_lei": {
"value": {
"count": 67,
"sample": [
{
"lei": "213800HRSK7HZZKAMU52",
"name": "3I 2023 CO-INVESTMENT LP"
},
{
"lei": "21380017P8XALJVC3B40",
"name": "3I INFRA 2022 WAREHOUSE LP"
},
{
"lei": "213800KIEEG89F7OAP86",
"name": "3I NORTH AMERICAN INFRASTRUCTURE FUND A LP"
}
]
},
"source": "gleif",
"as_at": "2026-11-18"
},
"identifiers": {
"value": {
"tickers": [
{
"ticker": "III",
"exchange": "London Stock Exchange"
}
],
"isin": [
"GB00B1YW4409"
],
"wikidata": "Q229764"
},
"source": "wikidata",
"as_at": "2026-11-19"
},
"website": {
"value": {
"url": "https://www.3i.com",
"machine_checked": true,
"social": {
"x": "https://x.com/3iplc",
"linkedin": "https://uk.linkedin.com/company/3i-group-plc"
},
"news_page": "https://www.3i.com/investor-relations/debt-investors/"
},
"source": "research",
"as_at": "2026-09-16"
},
"officers": {
"value": [
{
"officer_id": "C5b0fThRJxF_l8ZlGHLQ_pSjJio",
"name": "DUNN, Kevin John",
"role": "Secretary",
"appointed": "2007-11-01",
"resigned": null,
"url": "https://www.publiclimitedcompany.co.uk/director/dunn-kevin-john-c5b0fthrjxf_l8zlghlq_psjjio/"
},
{
"officer_id": "Gj6HuKjKqf51Xo61CDXm_6CPqmY",
"name": "BORROWS, Simon Alexander",
"role": "Director",
"appointed": "2011-10-17",
"resigned": null,
"url": "https://www.publiclimitedcompany.co.uk/director/borrows-simon-alexander-gj6hukjkqf51xo61cdxm_6cpqmy/"
},
{
"officer_id": "0qZND5fb36yxTMLnmIBN7rdNbjE",
"name": "HALAI, Jasi Hari",
"role": "Director",
"appointed": "2022-05-12",
"resigned": null,
"url": "https://www.publiclimitedcompany.co.uk/director/halai-jasi-hari-0qznd5fb36yxtmlnmibn7rdnbje/"
}
],
"source": "ch_officers",
"as_at": "2026-11-18"
},
"board": {
"value": {
"dirs": 9,
"secs": 1,
"appt12": 0,
"res12": 1,
"tenure": 7.2,
"resigned_total": 41
},
"source": "ch_officers",
"as_at": "2026-11-18"
},
"fair_payment_page": "https://www.fairpaymentcampaign.co.uk/company/01142830-3i-group-plc/",
"sources": {
"ch_bulk": {
"name": "Companies House, free company data product (BasicCompanyDataAsOneFile)",
"licence": "Open Government Licence v3.0",
"as_at": "2026-11-01"
},
"ch_officers": {
"name": "Companies House Public Data API, company officers",
"licence": "Open Government Licence v3.0",
"as_at": "2026-11-18"
},
"gleif": {
"name": "GLEIF Golden Copy (LEI and relationship records)",
"licence": "CC0 1.0",
"as_at": "2026-11-18"
},
"nsm": {
"name": "FCA National Storage Mechanism",
"licence": "NSM terms of use: any lawful purpose; filers grant users a licence including for any lawful commercial purpose",
"as_at": null
},
"wikidata": {
"name": "Wikidata",
"licence": "CC0 1.0",
"as_at": "2026-11-19"
},
"research": {
"name": "publiclimitedcompany.co.uk research: website identified by search and kept only where the domain matches the company",
"licence": "Our own work",
"as_at": "2026-09-16"
}
},
"attribution": [
"Contains public sector information licensed under the Open Government Licence v3.0.",
"Source: Companies House. Companies House does not verify the information filed with it.",
"Contract award data from Contracts Finder and Find a Tender (Crown Commercial Service and Cabinet Office), Open Government Licence v3.0."
]
} Licences and attribution
If you republish data from the API, keep these lines with it. Each record carries the ones that apply to it.
- Contains public sector information licensed under the Open Government Licence v3.0. Source: Companies House, which does not verify the information filed with it.
- Contract award data from Contracts Finder and Find a Tender (Crown Commercial Service and Cabinet Office), Open Government Licence v3.0.
- Donations data: Electoral Commission, register of donations, Open Government Licence v3.0.
- LEI data from GLEIF, and identifiers from Wikidata, both CC0 1.0.
- Announcement types and dates from the FCA National Storage Mechanism. The FCA does not endorse this site or the API.