--- name: z87:companies_uk description: 5.7M UK companies from Companies House. Unified search: company fields and monthly change tracking in one query. Find companies by name, track who moved to London, who changed status, who incorporated last month — all with field:value syntax. --- Anonymous: 600 tok/min. Key: `GET https://z87.ai/api/use` → `X-Api-Key` header, 6000 tok/min. On `429`, wait 1s. Single unified search index — company data and change tracking in one query. Company fields: name, number, postcode, town, sic, status, category, country. Change tracking fields: - kind: new (incorporated) or dissolved (struck off) - snapshot: date of change e.g. 2026-03 - changed: what changed — address, status, name, category, origin, dissolution, accounts, returns, mortgages, sic, lp, conf_stmt, previous_names - to_ / from_: what it changed to/from — e.g. to_address, to_town, from_status, to_sic All fields combine with AND: - /search?q=name:google — find by name - /search?q=kind:new sic:software — new software companies - /search?q=to_town:london from_town:manchester — relocated Manchester to London - /search?q=from_status:active to_status:liquidation — entering liquidation - /search?q=changed:mortgages name:holdings — mortgage activity at holdings companies - /search?q=kind:dissolved postcode:EC1V — dissolved in EC1V Detail: /number/{number} — full record with change history. Stats: /stats — all field values, snapshot dates. All endpoints accept both **GET with query parameters** and **POST with JSON body**. ## Endpoints ### `https://z87.ai/api/companies_uk/search` Unified search. Company fields: name, number, postcode, town, sic, status, category, country. Change fields: kind (new/dissolved), snapshot, changed (field group), to_, from_. All terms are AND'd. Example change fields: to_address, to_town, to_postcode, from_status, to_status, to_sic, from_category. | Param | Type | Required | Default | |-------|------|----------|---------| | q | string | **yes** | — | | limit | u32 | no | 20 | | offset | u32 | no | 0 | **Example:** `GET https://z87.ai/api/companies_uk/search?q=name:rekki&limit=1` **Response:** ```json { "companies": [ { "number": "07849223", "name": "REKKI LIMITED", "postcode": "NW6 6RJ", "town": "LONDON", "status": "Active", "category": "Private Limited Company", "incorporation_date": "2011-11-16", "sic_codes": ["82990 - Other business support service activities n.e.c."] } ], "total": 2, "limit": 1, "offset": 0 } ``` ### `https://z87.ai/api/companies_uk/number/{number}` Company detail by Companies House number, with full change history No parameters. **Example:** `GET https://z87.ai/api/companies_uk/number/11743365` **Response:** ```json { "company": { "number": "11743365", "name": "!BIG IMPACT GRAPHICS LIMITED", "address_line1": "124 CITY ROAD", "address_line2": "", "town": "LONDON", "county": "", "country": "", "postcode": "EC1V 2NX", "category": "Private Limited Company", "status": "Active", "country_of_origin": "United Kingdom", "incorporation_date": "2018-12-28", "dissolution_date": "", "sic_codes": [ "59112 - Video production activities", "63120 - Web portals", "74100 - specialised design activities", "74201 - Portrait photographic activities" ], "accounts_category": "DORMANT", "mortgages_outstanding": 0, "previous_names": [], "first_seen": "2026-02", "changes": [ { "snapshot": "2026-03", "kind": "changed", "fields": [ {"field": "po_box", "from": "4385", "to": ""}, { "field": "address_line1", "from": "11743365 - COMPANIES HOUSE DEFAULT ADDRESS", "to": "124 CITY ROAD" }, {"field": "town", "from": "CARDIFF", "to": "LONDON"}, {"field": "postcode", "from": "CF14 8LH", "to": "EC1V 2NX"}, {"field": "status", "from": "Active - Proposal to Strike off", "to": "Active"} ] } ] } } ``` ### `https://z87.ai/api/companies_uk/stats` All searchable field values, change filter options, snapshot dates No parameters. **Example:** `GET https://z87.ai/api/companies_uk/stats` **Response:** ```json { "total_companies": 5883354, "new_incorporations": 0, "dissolved": 185179, "changed": 2649237, "snapshots": ["2026-02", "2026-03", "2026-04", "2026-05"], "search_fields": { "name": "free text company name", "number": "Companies House number e.g. 08209948 or SC606050", "postcode": "UK postcode or prefix e.g. EC1V or SW1A 1AA", "town": "registered office town e.g. LONDON, MANCHESTER", "sic": "SIC code number or keyword e.g. 99999 or dormant or software", "status": "company status — see fields.status for all values", "category": "company type — see fields.category for all values", "country": "registered address country — see fields.country for all values" }, "change_fields": [ "kind", "snapshot", "changed", "from_name", "to_name", "from_care_of", "to_care_of", "from_address", "to_address", "from_po_box", "to_po_box", "from_address_line1", "to_address_line1", "from_address_line2", "to_address_line2", "from_town", "to_town", "from_county", "to_county", "from_country", "to_country", "from_postcode", "to_postcode", "from_category", "to_category", "from_status", "to_status", "from_country_of_origin", "to_country_of_origin", "from_origin", "to_origin", "from_dissolution_date", "to_dissolution_date", "from_dissolution", "to_dissolution", "from_accounts_ref_day", "to_accounts_ref_day", "from_accounts", "to_accounts", "from_accounts_ref_month", "to_accounts_ref_month", "from_accounts_next_due", "to_accounts_next_due", "from_accounts_last_made", "to_accounts_last_made", "from_accounts_category", "to_accounts_category", "from_returns_next_due", "to_returns_next_due", "from_returns", "to_returns", "from_returns_last_made", "to_returns_last_made", "from_mortgages_charges", "to_mortgages_charges", "from_mortgages", "to_mortgages", "from_mortgages_outstanding", "to_mortgages_outstanding", "from_mortgages_part_satisfied", "to_mortgages_part_satisfied", "from_mortgages_satisfied", "to_mortgages_satisfied", "from_sic1", "to_sic1", "from_sic", "to_sic", "from_sic2", "to_sic2", "from_sic3", "to_sic3", "from_sic4", "to_sic4", "from_lp_gen_partners", "to_lp_gen_partners", "from_lp", "to_lp", "from_lp_lim_partners", "to_lp_lim_partners", "from_conf_stmt_next_due", "to_conf_stmt_next_due", "from_conf_stmt", "to_conf_stmt", "from_conf_stmt_last_made", "to_conf_stmt_last_made", "from_previous_names", "to_previous_names" ], "fields": { "status": [ "Active", "Active - Proposal to Strike off", "Liquidation", "ADMINISTRATION ORDER", "Voluntary Arrangement", "In Administration", "In Administration/Administrative Receiver", "Live but Receiver Manager on at least one charge", "VOLUNTARY ARRANGEMENT / RECEIVER MANAGER", "In Administration/Receiver Manager", "RECEIVERSHIP", "ADMINISTRATIVE RECEIVER", "RECEIVER MANAGER / ADMINISTRATIVE RECEIVER", "VOLUNTARY ARRANGEMENT / ADMINISTRATIVE RECEIVER", "Dissolved" ], "category": [ "Private Limited Company", "Other company type", "PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)", "Community Interest Company", "Charitable Incorporated Organisation", "Registered Society", "Limited Partnership", "Overseas Entity", "Royal Charter Company", "PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)", "Limited Liability Partnership", "Public Limited Company", "Scottish Charitable Incorporated Organisation", "Private Unlimited Company", "Old Public Company", "Private Unlimited", "Scottish Partnership", "Investment Company with Variable Capital (Securities)", "Investment Company with Variable Capital", "Industrial and Provident Society", "United Kingdom Economic Interest Grouping", "Investment Company with Variable Capital(Umbrella)", "PRIV LTD SECT. 30 (Private limited company, section 30 of the Companies Act)", "Converted/Closed", "United Kingdom Societas", "Protected Cell Company", "Other Company Type", "Further Education and Sixth Form College Corps" ], "country": [ "ENGLAND", "UNITED KINGDOM", "SCOTLAND", "GUERNSEY", "MONGOLIA", "GERMANY", "POLAND", "WALES", "ISRAEL", "BULGARIA", "AUSTRIA", "KAZAKHSTAN", "PARAGUAY", "ROMANIA", "LATVIA", "BRAZIL", "CROATIA", "ITALY", "NORTHERN IRELAND", "NETHERLANDS", "UNITED STATES", "GIBRALTAR", "CANADA", "FRANCE", "JERSEY", "SURREY", "MAURITIUS", "MARSHALL ISLANDS", "VIRGIN ISLANDS, BRITISH", "BERMUDA", "CURACAO", "ISLE OF MAN", "ANGUILLA", "LUXEMBOURG", "HONG KONG", "CAYMAN ISLANDS", "SAINT KITTS AND NEVIS", "SINGAPORE", "AUSTRALIA", "NEW ZEALAND", "BAHAMAS", "MALAYSIA", "TURKS AND CAICOS ISLANDS", "MALTA", "SEYCHELLES", "CYPRUS", "VIRGIN ISLANDS", "CHANNEL ISLANDS", "LIBERIA", "SOUTH AFRICA", "...155 more" ], "country_of_origin": [ "United Kingdom", "CHANNEL ISLANDS", "MONGOLIA", "WEST GERMANY", "POLAND", "ISRAEL", "BULGARIA", "ROMANIA", "AUSTRIA", "KAZAKHSTAN", "PARAGUAY", "LATVIA", "BRAZIL", "CROATIA", "ITALY", "NETHERLANDS", "UNITED STATES", "GIBRALTAR", "CANADA", "FRANCE", "JERSEY", "MAURITIUS", "GUERNSEY", "MARSHALL ISLANDS", "VIRGIN ISLANDS, BRITISH", "BERMUDA", "CURACAO", "ISLE OF MAN", "ANGUILLA", "LUXEMBOURG", "HONG KONG", "CAYMAN ISLANDS", "DOMINICA", "SINGAPORE", "AUSTRALIA", "NEW ZEALAND", "BAHAMAS", "MALAYSIA", "TURKS AND CAICOS ISLANDS", "SAINT KITTS AND NEVIS", "SEYCHELLES", "CYPRUS", "VIRGIN ISLANDS", "MALTA", "LIBERIA", "SOUTH AFRICA", "GERMANY", "UNITED ARAB EMIRATES", "NORWAY", "IRELAND", "...176 more" ], "accounts_category": [ "DORMANT", "NO ACCOUNTS FILED", "TOTAL EXEMPTION FULL", "MICRO ENTITY", "FULL", "UNAUDITED ABRIDGED", "GROUP", "ACCOUNTS TYPE NOT AVAILABLE", "SMALL", "AUDIT EXEMPTION SUBSIDIARY", "MEDIUM", "TOTAL EXEMPTION SMALL", "FILING EXEMPTION SUBSIDIARY", "AUDITED ABRIDGED", "INITIAL", "PARTIAL EXEMPTION" ], "sic_codes": [ "99999 - Dormant Company", "59112 - Video production activities", "63120 - Web portals", "74100 - specialised design activities", "74201 - Portrait photographic activities", "86210 - General medical practice activities", "70229 - Management consultancy activities other than financial management", "58290 - Other software publishing", "62090 - Other information technology service activities", "68209 - Other letting and operating of own or leased real estate", "None Supplied", "90010 - Performing arts", "68320 - Management of real estate on a fee or contract basis", "85600 - Educational support services", "86900 - Other human health activities", "98000 - Residents property management", "68100 - Buying and selling of own real estate", "82110 - Combined office administrative service activities", "56101 - Licensed restaurants", "86230 - Dental practice activities", "64209 - Activities of other holding companies n.e.c.", "73110 - Advertising agencies", "82990 - Other business support service activities n.e.c.", "43320 - Joinery installation", "43390 - Other building completion and finishing", "43999 - Other specialised construction activities n.e.c.", "43220 - Plumbing, heat and air-conditioning installation", "74990 - Non-trading company", "41100 - Development of building projects", "69109 - Activities of patent and copyright agents; other legal activities n.e.c.", "84300 - Compulsory social security activities", "88990 - Other social work activities without accommodation n.e.c.", "81210 - General cleaning of buildings", "81222 - Specialised cleaning services", "88100 - Social work activities without accommodation for the elderly and disabled", "85200 - Primary education", "85310 - General secondary education", "58190 - Other publishing activities", "73120 - Media representation services", "58110 - Book publishing", "56102 - Unlicensed restaurants and cafes", "85520 - Cultural education", "96090 - Other service activities n.e.c.", "33170 - Repair and maintenance of other transport equipment n.e.c.", "49410 - Freight transport by road", "63110 - Data processing, hosting and related activities", "78300 - Human resources provision and management of human resources functions", "2875 - Manufacture other fabricated metal products", "63990 - Other information service activities n.e.c.", "86101 - Hospital activities", "...1131 more" ] } } ``` ### `https://z87.ai/api/companies_uk/random` Random company No parameters. **Example:** `GET https://z87.ai/api/companies_uk/random` **Response:** ```json { "company": { "number": "16540092", "name": "PATROPE WINDOW DESIGN AND INSTALLATIONS LTD", "address_line1": "20 GARDEN CLOSE", "address_line2": "", "town": "LONDON", "county": "GREATER LONDON", "country": "UNITED KINGDOM", "postcode": "SE12 9TG", "category": "Private Limited Company", "status": "Active", "country_of_origin": "United Kingdom", "incorporation_date": "2025-06-24", "dissolution_date": "", "sic_codes": ["43342 - Glazing"], "accounts_category": "NO ACCOUNTS FILED", "mortgages_outstanding": 0, "previous_names": [], "first_seen": "2026-02", "changes": [] } } ``` ## License The z87 API code is MIT licensed. Each dataset carries its upstream license: - **companies_uk**: Contains public sector information licensed under the Open Government Licence v3.0 (https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). Crown Copyright. Source: Companies House. --- ## Other z87 Datasets - [chess](https://z87.ai/api/chess/SKILL.md) — 1B+ Lichess games (2000+ Elo, 2013-2026) - [colors](https://z87.ai/api/colors/SKILL.md) — Unified paint color database: ~30K colors across 20+ brands with cross-brand matching via CIEDE2000 perceptual distance, color harmony generation, coordinating color strips, and palette suggestions. - [countries](https://z87.ai/api/countries/SKILL.md) — 247 countries with 282 indicators (57 static, 225 timeseries) across economics, health, demographics, energy, environment, education, and more - [design](https://z87.ai/api/design/SKILL.md) — 1,003 production-grade frontend designs with HTML, screenshots, prompts, and structured metadata (26 categories, 40 styles, 4K+ tags) - [food](https://z87.ai/api/food/SKILL.md) — Recipes, FDC ingredients, and food products: 13.5K recipes with nutrition, 8K+ FDC ingredients, curated products with Nutri-Score and NOVA ratings. - [gbif](https://z87.ai/api/gbif/SKILL.md) — GBIF Backbone Taxonomy: 7.7 million taxa with full taxonomic hierarchy, synonym resolution, tree navigation, and full-text search across the tree of life. - [gutenberg](https://z87.ai/api/gutenberg/SKILL.md) — 60,000 Project Gutenberg books with chapter-level access, BM25 full-text search, cover art, illustrations, and AI-generated tags (genre, mood, era, locations, five-word summaries). - [holidays](https://z87.ai/api/holidays/SKILL.md) — 3,391 public holidays across 121 countries (2026–2027) - [home](https://z87.ai/api/home/SKILL.md) — Unified smart home device database - [jokes](https://z87.ai/api/jokes/SKILL.md) — 41,000 jokes from three sources, AI-tagged with category, rating, topics, and offensive score - [manpages](https://z87.ai/api/manpages/SKILL.md) — 142K Linux man pages with AI-generated cheat cards, category tags, use-frequency scores, and plain-english descriptions - [movies](https://z87.ai/api/movies/SKILL.md) — 360K+ movies with 40-axis taste profiles, cast, themes, ratings, and soundtrack data - [mtg](https://z87.ai/api/mtg/SKILL.md) — 29K Magic: The Gathering cards with synergy graph engine, combo detection, and Commander deck builder. - [music](https://z87.ai/api/music/SKILL.md) — 651K artists, 500K+ albums, 1M+ songs from MusicBrainz with genre, country, and member data - [osm](https://z87.ai/api/osm/SKILL.md) — 46M+ OpenStreetMap POIs with Hilbert-curve spatial index and BM25 text search - [podcast](https://z87.ai/api/podcast/SKILL.md) — 1M+ podcasts from PodcastIndex with categories, language, episode counts, popularity scores, and cadence estimates - [restaurants](https://z87.ai/api/restaurants/SKILL.md) — 10K London restaurants with menus, Michelin stars, ingredient category scores (seafood, meat, game, etc.), and capacity data - [solve](https://z87.ai/api/solve/SKILL.md) — Computation engine: symbolic algebra, statistics, regression, finance, graph algorithms, Monte Carlo simulation - [wikipedia](https://z87.ai/api/wikipedia/SKILL.md) — 7.2 million English Wikipedia articles with full markdown content, infoboxes, inter-article links, and geographic coordinates. - [wiktionary](https://z87.ai/api/wiktionary/SKILL.md) — 8M+ Wiktionary entries across 4,000+ languages Full index: [https://z87.ai/api/SKILL.md](https://z87.ai/api/SKILL.md)