Search Companies

If true (default), wait for results and return them directly. If false, return an orderId immediately. Results will be delivered via webhook (recommended) or can be polled using GET /v2/companies/search/runs/{orderId}.

Defaulttrue

batch?boolean

Set to true for bulk, non-interactive requests. They run at lower priority than interactive requests.

Defaultfalse

Header Parameters

Kausate-Version?string

Default"2025-04-01"

Formatdate

X-Customer-Id?|

Optional customer ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://api.kausate.com/v2/companies/search" \  -H "Kausate-Version: 2025-04-01" \  -H "Content-Type: application/json" \  -d '{    "companyName": "Lindt",    "jurisdictionCode": "de"  }'

{
  "orderId": "live-search-de-lindt-org_01ABC-20240319143022",
  "customerReference": "search-ref-123",
  "metadata": {
    "team": "kyb",
    "ticket": "ACME-42"
  }
}

{
  "detail": "Invalid company ID format",
  "code": "request.invalid",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "API key is required",
  "code": "auth.unauthorized",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Invalid API key",
  "code": "auth.forbidden",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": [
    {
      "loc": [
        "body",
        "kausateId"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "request.invalid",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "The data source is rate-limiting requests right now, please try again later",
  "code": "source.rate_limited",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "An unexpected error occurred. If this persists, please contact support@kausate.com",
  "code": "internal.unexpected",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "This capability is offered for the requested jurisdiction but is not usable right now because of a fault on our side. Please contact support@kausate.com",
  "code": "capability.not_available",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Network error while reaching the data source",
  "code": "source.network_error",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Data source temporarily unavailable",
  "code": "source.unavailable",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

Search for companies in real-time from official business registries. Returns results with Kausate IDs.

Authorization

api_key

X-API-Key<token>

In: header

Query Parameters

sync?boolean

Defaulttrue

batch?boolean

Set to true for bulk, non-interactive requests. They run at lower priority than interactive requests.

Defaultfalse

Header Parameters

Kausate-Version?string

Default"2025-04-01"

Formatdate

X-Customer-Id?|

Optional customer ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

companyName?|

Company name to search for. May be combined with companyNumber to narrow the search where the jurisdiction supports it (e.g. Germany, where the register number alone is not unique).

companyNumber?|

Company registration number. Automatically mapped to the jurisdiction-specific identifier (e.g., SIREN for FR, FNR for AT, NIF for ES/PT). May be combined with companyName to narrow the search where the jurisdiction supports it.

advancedQuery?||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

Advanced search using local identifier components.

jurisdictionCode?string

Jurisdiction code: lowercase ISO 3166-1 alpha-2 country code or ISO 3166-2 subdivision code (e.g. de, us-ca).

Default"de"

Value in

"aa" | "ad" | "ae" | "af" | "ag" | "ai" | "al" | "am" | "ao" | "aq" | "ar" | "as" | "at" | "au" | "aw" | "ax" | "az" | "ba" | "bb" | "bd" | "be" | "bf" | "bg" | "bh" | "bi" | "bj" | "bl" | "bm" | "bn" | "bo" | "bq" | "br" | "bs" | "bt" | "bv" | "bw" | "by" | "bz" | "ca" | "ca-ab" | "ca-bc" | "ca-mb" | "ca-nb" | "ca-nl" | "ca-ns" | "ca-nt" | "ca-nu" | "ca-on" | "ca-pe" | "ca-qc" | "ca-sk" | "ca-yt" | "cc" | "cd" | "cf" | "cg" | "ch" | "ci" | "ck" | "cl" | "cm" | "cn" | "co" | "cr" | "cu" | "cv" | "cw" | "cx" | "cy" | "cz" | "de" | "dj" | "dk" | "dm" | "do" | "dz" | "ec" | "ee" | "eg" | "eh" | "er" | "es" | "et" | "fi" | "fj" | "fk" | "fm" | "fo" | "fr" | "ga" | "gb" | "gd" | "ge" | "gf" | "gg" | "gh" | "gi" | "gl" | "gm" | "gn" | "gp" | "gq" | "gr" | "gs" | "gt" | "gu" | "gw" | "gy" | "hk" | "hm" | "hn" | "hr" | "ht" | "hu" | "id" | "ie" | "il" | "im" | "in" | "io" | "iq" | "ir" | "is" | "it" | "je" | "jm" | "jo" | "jp" | "ke" | "kg" | "kh" | "ki" | "km" | "kn" | "kp" | "kr" | "kw" | "ky" | "kz" | "la" | "lb" | "lc" | "li" | "lk" | "lr" | "ls" | "lt" | "lu" | "lv" | "ly" | "ma" | "mc" | "md" | "me" | "mf" | "mg" | "mh" | "mk" | "ml" | "mm" | "mn" | "mo" | "mp" | "mq" | "mr" | "ms" | "mt" | "mu" | "mv" | "mw" | "mx" | "my" | "mz" | "na" | "nc" | "ne" | "nf" | "ng" | "ni" | "nl" | "no" | "np" | "nr" | "nu" | "nz" | "om" | "pa" | "pe" | "pf" | "pg" | "ph" | "pk" | "pl" | "pm" | "pn" | "pr" | "ps" | "pt" | "pw" | "py" | "qa" | "re" | "ro" | "rs" | "ru" | "rw" | "sa" | "sb" | "sc" | "sd" | "se" | "sg" | "sh" | "si" | "sj" | "sk" | "sl" | "sm" | "sn" | "so" | "sr" | "ss" | "st" | "sv" | "sx" | "sy" | "sz" | "tc" | "td" | "tf" | "tg" | "th" | "tj" | "tk" | "tl" | "tm" | "tn" | "to" | "tr" | "tt" | "tv" | "tw" | "tz" | "ua" | "ug" | "um" | "us" | "us-ak" | "us-al" | "us-ar" | "us-ca" | "us-co" | "us-ct" | "us-dc" | "us-de" | "us-fl" | "us-ga" | "us-hi" | "us-ia" | "us-id" | "us-il" | "us-ks" | "us-la" | "us-ma" | "us-md" | "us-me" | "us-mi" | "us-mo" | "us-ms" | "us-nc" | "us-nd" | "us-nj" | "us-nv" | "us-ny" | "us-oh" | "us-or" | "us-pa" | "us-ri" | "us-tx" | "us-ut" | "us-wa" | "us-wv" | "us-wy" | "uy" | "uz" | "va" | "vc" | "ve" | "vg" | "vi" | "vn" | "vu" | "wf" | "ws" | "xk" | "ye" | "yt" | "za" | "zm" | "zw" | "zz" | "ec"

customerReference?|

Optional customer reference for tracking

metadata?|

Optional customer-supplied JSON metadata echoed back in order responses. Serialized JSON must be at most 4096 bytes.

Response Body

`application/json`

curl -X POST "https://api.kausate.com/v2/companies/search" \  -H "Kausate-Version: 2025-04-01" \  -H "Content-Type: application/json" \  -d '{    "companyName": "Lindt",    "jurisdictionCode": "de"  }'

{
  "orderId": "live-search-de-lindt-org_01ABC-20240319143022",
  "customerReference": "search-ref-123",
  "metadata": {
    "team": "kyb",
    "ticket": "ACME-42"
  }
}

{
  "detail": "Invalid company ID format",
  "code": "request.invalid",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "API key is required",
  "code": "auth.unauthorized",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Invalid API key",
  "code": "auth.forbidden",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": [
    {
      "loc": [
        "body",
        "kausateId"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "request.invalid",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "The data source is rate-limiting requests right now, please try again later",
  "code": "source.rate_limited",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "An unexpected error occurred. If this persists, please contact support@kausate.com",
  "code": "internal.unexpected",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "This capability is offered for the requested jurisdiction but is not usable right now because of a fault on our side. Please contact support@kausate.com",
  "code": "capability.not_available",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Network error while reaching the data source",
  "code": "source.network_error",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

{
  "detail": "Data source temporarily unavailable",
  "code": "source.unavailable",
  "request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

500application/json

501application/json

502application/json

503application/json

Async order accepted (poll via GET /v2/companies/search/runs/{orderId})

Completed result (sync=true / webhook payload / GET /v2/companies/search/runs/{orderId})

Search Companies

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

500application/json

501application/json

502application/json

503application/json

Async order accepted (poll via GET /v2/companies/search/runs/{orderId})

Completed result (sync=true / webhook payload / GET /v2/companies/search/runs/{orderId})

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`