Search for companies

Returns a paginated list of companies matching the query, searched by company name or company number within the specified jurisdiction.

Query Parameters

q
Type: string
required

Company name or company number to search for
jurisdiction
Type: string
required

ISO 3166-1 alpha-2 jurisdiction code
pageSize
Type: integer Format: int32
required

Number of results per page (1–50)

Responses

application/json
400

Invalid request parameters
401

Unauthorized — invalid or missing Bearer token

get/v1/company/search

curl 'https://public-api.somewhatok.link/v1/company/search?q=Acme%20Ltd&jurisdiction=GB&pageSize=10' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "results": [
    {
      "name": "Acme Ltd",
      "companyNumber": "12345678",
      "jurisdiction": "GB",
      "status": "ACTIVELY_TRADING",
      "address": "1 High St, London, EC1A 1AA",
      "addressStructured": {
        "streetLine1": "1 High St",
        "streetLine2": "string",
        "city": "London",
        "region": "Greater London",
        "postcode": "EC1A 1AA",
        "country": "GB",
        "latitude": 51.5188,
        "longitude": -0.103
      },
      "incorporatedDate": "2015-06-01T00:00:00Z",
      "isGrandMember": false,
      "previousNames": [
        {
          "name": "Acme Trading Ltd",
          "startDate": "2010-01-01",
          "endDate": "2015-05-31"
        }
      ],
      "avatar": {
        "image": "https://cdn.grand.work/logos/acme.png",
        "initials": "A"
      }
    }
  ],
  "total": 42
}

Search results