GET
/
v2
/
search
curl --request GET \
  --url https://api.getsemaphore.com/v2/search \
  --header 'x-api-key: <api-key>'
[
  {
    "address": {
      "addressLine1": "10 rue de la Fraternité",
      "addressLine2": "Semaphore Building",
      "city": "Bagnolet",
      "postalCode": "93170",
      "region": "FR",
      "countryCode": "FR",
      "poBox": "PO Box 123",
      "careOf": "c/o John Doe",
      "state": "Île-de-France"
    },
    "companyNumber": "932884117",
    "legalName": "SEMAPHORE",
    "legalNameInEnglish": "Test Display Hong Kong Trading Limited",
    "country": "FR"
  }
]

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
country
enum<string>
required

Country code, which can be an ISO country code, or for the United States, a combination of "US" and the state code (e.g., "US-CA" for California).

Available options:
BE,
CH,
CN,
DE,
ES,
FR,
GB,
IT,
NL,
PT,
HK,
LU,
MT
​
query
string
required

The search query, which can be a company name or registration number. Note that search capabilities may vary by country, with some supporting only name or registration number searches.

Example:

"Semaphore"

Response

200 - application/json

List of companies

The response is of type object[].