Search companies

GET {{baseUrl}}/search?freeText=construction

Search companies matching query string parameters.

Request Params

KeyDatatypeRequiredDescription
requestKeystringUsed when paging in a previous searched result
pageSizestringNumber of results to return per pagination page
fromstringfirst result to return from the resultset that is being paged through
addressstringCompany address
addressstringCompany address
freeTextstringCompany name or company id to search for
companyRegistrationDatestringThe date the company searched for should have been registered, range input with : between is accepted
countystringCounty the searched for company should be registered in
industryCodestringThe primary industry code the company to search for belongs to
industryCodestringThe primary industry code the company to search for belongs to
legalGroupCodestringThe legal group code for the type of company to search for
legalGroupCodestringThe legal group code for the type of company to search for
legalGroupTextstringThe legal group text for the type of company to search for
legalGroupTextstringThe legal group text for the type of company to search for
numberEmployeesIntervalstringEmployees interval
numberEmployeesIntervalstringEmployees interval
statusCodestringStatus code that the searched for company should be referenced as
statusCodestringStatus code that the searched for company should be referenced as
townstringTown the searched for company should be registered in
townstringTown the searched for company should be registered in
vatRegstringVat registered
zipCodestringZip code the searched for company should be registered in
zipCodestringZip code the searched for company should be registered in
plNetOperatingIncomestringNet operating income, range type, tkr

RESPONSES

status: OK

{"hitCount":"\u003cinteger\u003e","hits":[{"companyId":"\u003cstring\u003e","companyName":"\u003cstring\u003e","legalGroupCode":"\u003cstring\u003e","legalGroupText":"\u003cstring\u003e","town":"\u003cstring\u003e"},{"companyId":"\u003cstring\u003e","companyName":"\u003cstring\u003e","legalGroupCode":"\u003cstring\u003e","legalGroupText":"\u003cstring\u003e","town":"\u003cstring\u003e"}],"metrics":{"industryCode":"\u003cobject\u003e","legalGroupCode":"\u003cobject\u003e","numberEmployeesInterval":"\u003cobject\u003e","plNetOperatingIncome":"\u003cobject\u003e","statusCode":"\u003cobject\u003e","town":"\u003cobject\u003e","vatReg":"\u003cobject\u003e","zipCode":"\u003cobject\u003e"},"next":"\u003cstring\u003e","previous":"\u003cstring\u003e","requestKey":"\u003cstring\u003e"}