Skip to main content
API docs by Redocly

Kontakto Business Data Service (1.0.0)

Download OpenAPI specification:Download

Kontakto API Support: [email protected] Terms of Service

The Kontakto Business Data Service is a high-performance, low-latency API for accessing Finnish business data from multiple sources.

Engineered with exceptional speed in mind, Kontakto is an ideal solution for powering real-time, user-facing applications where performance is critical.

Example Use Cases:

  • Instant Autocomplete: Type-ahead search boxes that feel instantaneous to the user.
  • Real-time Data Enrichment: Enrich user profiles or company records on the fly without adding user-perceptible delay.
  • Dynamic Form Validation: Validate business information (like company names or VAT numbers) as users type.

Register for an API key

Create an account at Kontakto.fi and get your API key.

Companies

Get company by business ID

Returns company details based on the business ID

Authorizations:
apiKeyAuth
path Parameters
businessId
required
string
Example: 1234567-8

Business ID of the company

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "businessId": "string",
  • "vatId": "string",
  • "businessName": "string",
  • "auxiliaryNames": [
    ],
  • "parallelNames": [
    ],
  • "operationalStatus": true,
  • "statusAsOf": "string",
  • "statusDescription": "string",
  • "countryCode": "string",
  • "languageCode": "string",
  • "domicileCity": "string",
  • "domicileCode": "string",
  • "industryDescription": "string",
  • "industryAsOf": "string",
  • "tol2008Code": "string",
  • "legalForm": "string",
  • "legalFormCode": "string",
  • "legalFormAsOf": "string",
  • "sector": "associations_and_foundations",
  • "establishmentDate": "string",
  • "createdAt": "string",
  • "otherAddress": [
    ],
  • "website": [
    ],
  • "domain": [
    ],
  • "phoneNumber": [
    ],
  • "register": [
    ],
  • "eInvoiceAddress": [
    ],
  • "kontaktoRating": {
    }
}

Search

Search companies (typeahead)

Search companies with compact results for typeahead functionality. Hides black-rated companies and companies who have requested to be hidden from Kontakto platform by default. You can use advanced search to get all companies and do the filtering manually.

Authorizations:
apiKeyAuth
query Parameters
q
string
Example: q=Ratkaisu

Search query

limit
string
Example: limit=10

Maximum number of results

Responses

Response samples

Content type
application/json
{
  • "hits": [
    ],
  • "estimatedTotalHits": 0,
  • "processingTimeMs": 0
}

Advanced company search

Advanced company search with powerful filtering and field projection capabilities.

Filtering: Use operations =, !=, >=, >, <=, <, IN, NOT IN, TO, EXISTS, NOT EXISTS, IS NULL, IS NOT NULL, IS EMPTY, IS NOT EMPTY, CONTAINS, NOT CONTAINS, STARTS WITH, NOT STARTS WITH

Field Projection: Use the fields parameter to specify which fields to include in the response. You can use any fields specified in the company schema, including nested fields with dot notation (e.g., kontaktoRating.color). If omitted, returns complete company data.

Authorizations:
apiKeyAuth
Request Body schema: application/json
q
string

Search query

filter
string

Filter syntax

fields
string

Comma-separated list of fields to include in the response. Use dot notation for nested fields (e.g., 'kontaktoRating.color'). If omitted, returns complete company data. Examples: 'businessId,businessName' for minimal data, 'businessId,businessName,kontaktoRating.color,address.city' for specific fields.

limit
number
Default: 10

Maximum number of results (1-100, default: 10)

offset
number
Default: 0

Number of results to skip

Responses

Request samples

Content type
application/json
{
  • "q": "Kontakto",
  • "filter": "kontaktoRating.color = \"green\" AND postalAddress.city = \"Helsinki\"",
  • "fields": "businessId,businessName,kontaktoRating.color,address.city,website",
  • "limit": 10,
  • "offset": 0
}

Response samples

Content type
application/json
{
  • "hits": [
    ],
  • "query": "Kontakto",
  • "processingTimeMs": 15,
  • "limit": 10,
  • "offset": 0,
  • "estimatedTotalHits": 471
}

Postal Codes

Search postal codes

Search postal codes with compact results

Authorizations:
apiKeyAuth
query Parameters
q
string
Example: q=Helsinki

Search query

limit
string
Example: limit=10

Maximum number of results

Responses

Response samples

Content type
application/json
{
  • "hits": [
    ],
  • "estimatedTotalHits": 0,
  • "processingTimeMs": 0
}