Prospects

Find companies by sector, place, age and size — or lookalikes

Filters combine with AND; comma-separated values with OR. Needs at least one narrowing filter. like={company_number} searches that company's 4-digit SIC class (its postcode area first), scores up to 500 candidates on sector, location, size and age, and returns the closest with a similarity of 0–100. New-incorporation lists: incorporated_from=…&sort=newest.

get/prospects

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/prospects
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Query parameters

sicstring
postcodestring
townstring
statusstring

Comma list, or "any"

categorystring
accounts_categorystring
incorporated_fromstring date
incorporated_tostring date
min_age_yearsinteger
max_age_yearsinteger
min_turnoverinteger
max_turnoverinteger
min_employeesinteger
max_employeesinteger
min_net_assetsinteger
max_net_assetsinteger
has_chargesboolean
exclude_overdueboolean
likestring

Company number to find lookalikes of

sort'newest' | 'oldest' | 'name'
limitinteger
cursorstring

Response

Matching companies

Changes

No recorded changes to this operation across all 1 revision of this API.