Search companies

POST

/api/v1/companies/search

Full-text search across Swiss companies. Optionally filter by status, legal form, or canton.
Returns a paginated list of search-result rows.

offset is capped at 500 to prevent bulk enumeration; use a more specific query to narrow results.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Example

{
    "query": "Nestle",
    "status": [
        "active"
    ],
    "form_legal": [
        "Aktiengesellschaft"
    ],
    "canton": [
        "VD"
    ],
    "noga_ids": [
        10
    ],
    "limit": 20,
    "offset": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/companies/search' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "query": "Nestle",
    "status": [
        "active"
    ],
    "form_legal": [
        "Aktiengesellschaft"
    ],
    "canton": [
        "VD"
    ],
    "noga_ids": [
        10
    ],
    "limit": 20,
    "offset": 0
}'

Responses

🟢200

application/json

Paginated companies.

Bodyapplication/json

Example

{
    "success": true,
    "data": {
        "total": 250,
        "items": [
            {
                "id": 12345,
                "name": "Nestlé S.A.",
                "uid": "CHE-100.063.197",
                "status": "active",
                "legalform": "Aktiengesellschaft",
                "registerdate": "1866-01-01",
                "address": "string",
                "location": "Vevey",
                "canton": "VD",
                "slug": "nestle-sa"
            }
        ]
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠402PaymentRequired

🟠429TooManyRequests

🔴502UpstreamError

Modified at 2026-05-23 17:35:36

Liveness probe

AI-powered company search