This page has been moved to Mashape
Searching by advanced criteria
We have added multiple fields into the search engine to allow you to derive highly accurate results based on multiple criteria affecting a range of companies.
For example, the following string will bring back a list of companies within the EC postcode sector and a turnover of between £1m and £2m.
Other than name, we have a number of other URL variables which allow you to find companies via more flexible criteria.
The first four are text fields and will find any companies where that field contains the text you supply, for example:
https://companycheck.co.uk/api/json/search?apiKey=xxxxxxxxx&address=Nottingham&sicCode=1234 will return all companies whose address contains the word "Nottingham" and whose sicCode is 1234.
You may also search for companies by postcode and SIC code. The three URL variables available for you to query by are “name”, “postcode” and “sicCode.” You may choose one or more of these to make your query. For ease of implementation you may include them blank and they won't be used.
For example, the following will return all companies with a postcode beginning NG1 with a sicCode of 63110:
The next two are dissolved and active. Including dissolved=1 will only return dissolved companies, and vice versa for active. If you include &dissolved=1&active=1 then this is will return both dissolved and active companies. This has the same effect as not including either variable.
The remaining variables are financial variables. These work like the others except for the fact they also support ranges:
networth=1000000 is valid and so is networth=1000..20000
The double dot (..) notation is used to signify the range. It is important to always put the lowest number first, even with negative ranges:
networth=-4000..-200 is valid, networth=-200..-4000 is not valid.The API does support ranges from a negative number to a positive number, passing through 0, but for technical reasons we suggest that any range you provide doesn't pass through 0, as you may return a lot of results which have a 0 value due to us not having that data.
It's also worth noting that the sicCode variable also supports ranges.