Organizations

Search organizations

Search for organizations by name, address, or CIN — Company Identification Number (IČO). Supports partial matching and automatic diacritics handling. Name searches include typo tolerance, prefix matching, and return a name_highlighted field with highlight markers for building search-as-you-type UIs.

get/organizations

Request

  • Base URL: https://api.apino.sk/api/v1
  • URL: https://api.apino.sk/api/v1/organizations
  • Auth: HTTP bearer

Query parameters

namestring

Partial company name match (min 2 chars). Handles Slovak diacritics automatically.

addressstring

Partial address match (min 2 chars).

cinstring

Exact CIN (IČO) match.

countriesstring

Comma-separated country codes to include (SK, CZ). Default: SK (Slovak data only). Use "SK,CZ" to query both countries.

activeboolean

Filter active companies only. Default — all.

limitinteger

Results per page, 1–100.

offsetinteger

Pagination offset.

Response

Paginated list of organizations

countinteger

Number of results in this page

limitinteger

Limit used

offsetinteger

Offset used

has_moreboolean

Whether more results exist beyond this page

Example response

{
  "data": [
    {
      "withheld": {
        "fields": [
          "street",
          "postal_code",
          "address",
          "vat.ic_dph"
        ]
      }
    }
  ]
}

Changes

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