What it returns
Search the official UK company register (Companies House) and get clean company records. - **Look up companies** by company number: profile, status, SIC codes, registered office, previous names, accounts and confirmation statement deadlines, charges and insolvency flags. - **Directors and owners**: current officers (role, appointment date, nationality, occupation) and persons with significant control (natures of control). - **Lead lists**: filtered search by name, town or postcode, status, company type, SIC code and incorporation or dissolution date range. For example, every IT consultancy (62020) incorporated in Manchester last month. - **Name search** ranked by relevance.
One record per company: `companyNumber`, `companyName`, `status`, `type`, `incorporatedOn`, `dissolvedOn`, `sicCodes`, `address`, `postalCode`, `locality`, `url`; with details also `previousNames`, `nextAccountsDue`, `accountsOverdue`, `officers`, `significantControl` and optionally `recentFilings`.
Request
POST https://api.pushbuild.com/uk-companies-house/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
companyNumbers | list of strings | Look up these companies directly, e.g. 00445790. When set, the search fields below are ignored. |
query | string | Free-text company name search ranked by relevance (up to 1,000 results). |
nameIncludes | string | Filtered search: company name contains this text. |
nameExcludes | string | Filtered search: company name does not contain this text. |
location | string | Town, city or postcode of the registered office, e.g. Leeds or M1. |
statuses | list of strings | e.g. active, dissolved, liquidation, administration. |
companyTypes | list of strings | e.g. ltd, plc, llp, private-limited-guarant-nsc. |
sicCodes | list of strings | Industry codes, e.g. 62020 (IT consultancy), 56101 (restaurants). |
incorporatedFrom | string | YYYY-MM-DD. Use with Incorporated to for new-company lead lists. |
incorporatedTo | string | YYYY-MM-DD. |
dissolvedFrom | string | YYYY-MM-DD. |
dissolvedTo | string | YYYY-MM-DD. |
includeDetails | boolean | Fetch profile, directors and owners for every search result (slower). Always on for company numbers. Default: false. |
includeOfficers | boolean | Current officers with role, appointment date, nationality and occupation. Default: true. |
includeResignedOfficers | boolean | Also list officers who have resigned. Default: false. |
includeOwners | boolean | Current persons with significant control and their natures of control. Default: true. |
includeFilings | boolean | The 25 most recent filings. Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/uk-companies-house/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "tesco", "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 companys. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com