Introduction

Welcome to the Taloustutka API! You can use our API to access Taloustutka API endpoints, which provide various information of Finnish companies from our database.

Authentication

To authorize, use this code:

# With shell, you can just pass the correct header with each request
curl "api_endpoint_here"
  -H 'x-api-key: abcDEF!?@123456'

Make sure to replace abcDEF!?@123456 with your API key.

Taloustutka uses API keys to validate access to the API. You can get your own Taloustutka API key by contacting our sales.

Taloustutka API expects the API key to be included in all API requests to the server. The API key must be included in a header that looks like the following:

x-api-key: abcDEF!?@123456

Company Information

Company Basic Info

curl "https://api.taloustutka.fi/v1.0/basicinfo/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "businessId": "1234567-8",
  "name": "Company Oy",
  "domicile": "Helsinki",
  "location": "00100 Helsinki",
  "type": "OY",
  "mainIndustryCode": "A",
  "industrySectorCode": "01440",
  "companyStatus": "ACTIVE",
  "primaryPhoneNumber": "0401234567",
  "primaryWebAddress": "www.company.com",
  "primaryEmail": "contact@company.com",
  "reliablePartnerStatus": "OK",
  "tradeNames": [
    "Finnish Company",
    "Company Max"
  ],
  "registers": [
    "Kaupparekisteri",
    "Työnantajarekisteri"
  ],
  "addresses": [
    {
      "addressType": "POSTAL_ADDRESS",
      "streetAddress": "Isotie 1b",
      "postalCode": "00100",
      "postOffice": "Helsinki"
    },
    {
      "addressType": "VISITATION_ADDRESS",
      "streetAddress": "Helsinkitie 2",
      "postalCode": "00100",
      "postOffice": "Helsinki"
    },
    {
      "addressType": "ADDITIONAL_LOCATION",
      "streetAddress": "Tamperetie 3a",
      "postalCode": "33100",
      "postOffice": "Tampere"
    }
  ]
}

This endpoint is used to retrieve the basic information of a single company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/basicinfo/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
name	Name of the company.
domicile	Domicile of the company.
location	Postal code and county of the company location. Or just one of them if the other is unknown.
type	Type of the company. Possible values: OY, OYJ, YEH, KY, AOY, KVY, OK, SL, AY, AYH, SP, OP, SÄÄ, ETY, KKOY, VOY, VY, VOJ, HY, VALTLL, ETS, ASY, MOHLÖ, KONK, ELSYH, EYHT, YHME, MSÄÄ, US, KUNT, EVLUT, MUYP, MYH, RUSY, VAKK, KUNTYHT, VALT, MUVE, MJUO, YO, PK, ESÄÄ, MTYH, KVAKYH, KK, TYKA, ORTO, AHVE, TEKA, MUUKOY, MUU, MHY, LIY, EVL, KUNTLL.
mainIndustryCode	Code which indicates the primary business line of the company. See Industry in Codes to get more information about the code.
industrySectorCode	Specific sector of the industry of the company. See Industry in Codes to get more information about the code.
companyStatus	Status of the company. Possible values: ACTIVE, BUSINESS_ENDED, BANKRUPT, HALTED, LIQUIDATION, DEPT_RESTRUCTURING.
primaryPhoneNumber	Official phone number of the company.
primaryWebAddress	Website of the company.
primaryEmail	Email of the company.
reliablePartnerStatus	Status code indicating the Reliable Partner status. See Reliable Partner in Codes to get more information about the code.
tradeNames	Auxiliary and parallel names of the company.
registers	List of registers that the company is included in. Registers included: Työnantajarekisteri, Kaupparekisteri, Ennakkoperintärekisteri.
addresses	List of addresses associated with the company.
addressType	Type of address. Possible values: VISITATION_ADDRESS, POSTAL_ADDRESS, ADDITIONAL_LOCATION.
streetAddress	Name of the street and the house number.
postalCode	Postal code of the address.
postOffice	Post office/city of the address.

Company Financial Statements

curl "https://api.taloustutka.fi/v1.0/financialstatements/1234567-8/2"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "fiscalPeriodStartDate": "2018-12-31",
    "fiscalPeriodEndDate": "2019-01-01",
    "personnelCount": 7,
    "profitAndLoss": {
      "profitOfTheFinancialYear": 393845.34,
      "revenue": 751924.36
    },
    "assets": {
      "assetsTotal": 375530.62,
      "currentAssets": 225825.36,
      "nonCurrentAssets":  149705.26
    },
    "liabilities": {
      "capitalAndReserves": 328398.36,
      "creditors": 47132.26,
      "liabilitiesTotal": 375530.62
    }
  },
  {
    "fiscalPeriodStartDate": "2017-12-31",
    "fiscalPeriodEndDate": "2018-01-01",
    "estimatedPersonnelCount": 5,
    "profitAndLoss": {
      "profitOfTheFinancialYear": 209256.01,
      "revenue": 526926.50
    },
    "assets": {
      "assetsTotal": 250000.00,
      "currentAssets": 159626.18,
      "nonCurrentAssets": 90373.82
    },
    "liabilities": {
      "capitalAndReserves": 197302.80,
      "creditors": 52697.20,
      "liabilitiesTotal": 250000.00
    }
  }
]

Retrieves the financial statements data of a company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/financialstatements/<businessId>/<maxCount>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
maxCount	The maximum amount of fiscal periods to retrieve financial statements data from. Always retrieves the newest statements.

Response Values

Value name	Description
fiscalPeriodStartDate	Start date of the fiscal period.
fiscalPeriodEndDate	End date of the fiscal period.
personnelCount	Amount of personnel working for the company, often declared in the financial statement.
estimatedPersonnelCount	Estimate of the personnel count, if the personnel count is not declared in the financial statement. Based on the amount of work estimate for the fiscal period.
profitAndLoss	Profit and loss numbers from the financial statement.
assets	Assets numbers from the financial statement.
liabilities	Liabilities numbers from the financial statement.

Complete list of available financial statement number field values, and their Finnish/Swedish counterparts in original financial statements submitted by the company can be found here.

Company Rating

curl "https://api.taloustutka.fi/v1.0/ratings/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "rating": 9.0,
  "taloustutkaStars": 4.5,
  "creditLimit": 43450.93
}

Retrieves Taloustutka's company rating and suggested credit limit of a company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/ratings/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
rating	Rating score of the company from 0 to 10 (the higher, the better).
taloustutkaStars	Stars given to the company based on its performance from 0 to 5, using increments of 0.5.
creditLimit	Suggested credit limit of the company in euros, based on its performance during the fiscal period.

For details on how rating and stars are calculated, read the complete documentation of rating (in Finnish).

Company Key Figures

curl "https://api.taloustutka.fi/v1.0/keyfigures/1234567-8/2"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "fiscalPeriodStartDate": "2018-01-31",
    "fiscalPeriodEndDate": "2019-01-30",
    "accountsPayableTurnover": 4.33,
    "capitalInvested": 101487.79,
    "capitalTurnoverRatio": 246.52,
    "currentRatio": 2.07,
    "debtToIncomeRatio": 20.79,
    "equityRatio": 60.82,
    "grossProfit": 4.81,
    "grossProfitPercentage": 543136.57,
    "incomeBeforeExtraordinaryItems": 100,
    "incomeBeforeExtraordinaryItemsPercentage": 71877.13,
    "inventoriesTurnoverRate": 13.23,
    "invoicing": 546176.69,
    "liabilitiesPaybackPeriod": 27.82,
    "netFinancialExpensesToEbitdaRatio": 0,
    "netFinancialExpensesToSalesPercentage": 0.1,
    "netGearing": 0.02,
    "netProfit": -152.3,
    "netProfitPercentage": 71877.13,
    "netWorkingCapital": 13.23,
    "netWorkingCapitalPercentage": 121272.35,
    "ebitdaPercentage": 16.68,
    "ebitda": 90612.79,
    "operatingProfitGrowthPercentage": 174.66,
    "operatingProfitPercentage": 16.68,
    "overallProfit": 71877.13,
    "overallProfitPercentage": 13.23,
    "quickRatio": 2.07,
    "returnOfAssets": 41.13,
    "returnOnEquity": 84.23,
    "returnOnInvestment": 106.19,
    "revenueGrowthPercentage": 10.02,
    "turnoverOfAccountReceivables": 9.77,
    "valueAdded": 398214.26,
    "valueAddedPercentage": 1.29,
    "valueAddedPerPersonnelExpenses": 73.32,
    "workingCapital": -43452.03,
    "workingCapitalPercentage": -8
  },
  {
    "fiscalPeriodStartDate": "2017-01-31",
    "fiscalPeriodEndDate": "2018-01-30",
    "accountsPayableTurnover": 2.55,
    ...
  }
]

Retrieves various pre-calculated key figures featuring the performance of the company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/keyfigures/<businessId>/<maxCount>

Query Parameters

Parameter	Description
businessId	The Finnish business id (y-tunnus) of the company to retrieve the data from.
maxCount	The maximum amount of fiscal periods to retrieve key figures from. Always retrieves the newest key figures.

Response Values

Value name	Description
fiscalPeriodStartDate	Start date of the fiscal period, that the key figures are based on.
fiscalPeriodEndDate	End date of the fiscal period, that the key figures are based on.

Complete list of available key figure fields, and their names in English/Finnish/Swedish can be found from here.

Company News

curl "https://api.taloustutka.fi/v1.0/news/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "title": "New product launched!",
    "snippet": "We are launching our new product, the company API.",
    "sourceUrl": "https://www.company.com",
    "writeTime": "2020-01-27",
    "language": "EN"
  },
  {
    "title": "Expanding overseas",
    "snippet": "Company Oy is set to expand across Europe this year.",
    "sourceUrl": "https://www.news.fi",
    "writeTime": "2020-01-26",
    "language": "EN"
  }
]

Retrieves recent news articles and blog posts featuring a company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/news/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
title	Title of the news
snippet	Snippet taken from news content.
sourceUrl	Url of the original news article.
writeTime	Date when the news article was written
language	Language of the news article. Possible values: EN, FI.

Corporate Group Relations

curl "https://api.taloustutka.fi/v1.0/corporaterelations/2222222-2"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "businessId": "2222222-2",
  "name": "Finland Holdings Oy",
  "groupName": "EUROPE GROUP",
  "foreign": false,
  "parentCompanies": [
    {
      "identifierId": "11111111",
      "name": "Europe Group Holdings",
      "groupName": "EUROPE GROUP",
      "share": 100,
      "foreign": true
    }
  ],
  "childCompanies": [
    {
      "businessId": "4444444-4",
      "name": "Helsinki Power",
      "groupName": "EUROPE GROUP",
      "share": 40,
      "foreign": false
    }
  ]
}

Retrieves lists of all direct parent and child relations of the searched company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/corporaterelations/<businessId>|<identifierId>

Query Parameters

Either a businessId of a Finnish company or an identifier id of a foreign company can be used.

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
identifierId	Identifier id of of the foreign company to retrieve

Response Values

Value name	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
identifierId	Foreign companies are given an identifier id instead of a business id.
name	Name of the company.
groupName	Name of the corporate group, that the company belongs to.
share	Percentage of shares owned in the corporate relation.
foreign	Information whether the company is Finnish or foreign.
parentCompanies	Companies that own the searched company partially or fully.
childCompanies	Companies which the searched company owns partially or fully.

Personnel Information

Person Key

The person key is the person's unique identifier. It can be used to get information about the person in the person information endpoint. It can be acquired from personnel of company requests or from some Tutka requests.

Personnel Of Company

curl "https://api.taloustutka.fi/v1.0/responsiblepeople/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "businessId" : "1234567-8"
  "companyName" : "Company Oy"
  "rightOfSignatureCode" : "NIMA36"
  "responsiblePeople": [
    {
      "personKey": "-101010101",
      "dateOfBirth": "1972-12-29",
      "firstNames": "John Max",
      "lastName": "Smith",
      "nationalityCode": "FI",
      "domicile": "Espoo",
      "roles": [
        {
          "roleCode": "PR",
          "signatureRuleCode": "NIMO01",
          "roleStartDate": "2011-06-15"
        },
        {
          "roleCode": "PJ",
          "roleStartDate": "2011-06-15"
        },
        {
          "roleCode": "TJS",
          "roleStartDate": "2011-06-15"
        }
      ]
    },
    {
      "personKey": "202020202",
      "dateOfBirth": "1962-10-03",
      "firstNames": "Jane",
      "lastName": "Smith",
      "nationalityCode": "FI",
      "domicile": "Espoo",
      "roles": [
        {
          "roleCode": "TJ",
          "roleStartDate": "2010-01-31"
        }
      ]
    }
  ]
}

Retrieves all known key personnel of the company.

HTTP Request

GET https://api.taloustutka.fi/responsiblepeople/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
companyName	Name of the company.
rightOfSignatureCode	The company's right of the signature code. See Right Of Signature in Codes to get information about code.
responsiblePeople	List of the personnel associated to the company.
personKey	PersonKey of the person.
dateOfBirth	Birth date of the person.
firstNames	All first names of the person.
lastName	Last name of the person.
nationalityCode	Nationality of the person. See Nationality in Codes to get information about code.
domicile	Domicile of the person.
roles	List of roles, that the person has in the company.
roleCode	Code of the role. See Company-Role in Codes to get information about code.
signatureRuleCode	If the role in the company is procuration holder (roleCode PR), the signature rule code is included in the data. See Signature-Rule in Codes to get information about code.
roleStartDate	Date of when the person started in this role.

Person Information

curl "https://api.taloustutka.fi/v1.0/responsibleperson/12345"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "personKey": "-101010101",
  "dateOfBirth": "1972-12-29",
  "firstNames": "John Max",
  "lastName": "Smith",
  "nationalityCode": "FI",
  "domicile": "Espoo",
  "companyRelations": [
    {
      "businessId": "8765432-1",
      "companyName": "Smith Productions",
      "rolesInCompany": [
        {
          "roleCode": "ELI",
          "roleStartDate": "2005-05-11"
        }
      ]
    }
    {
      "businessId": "1234567-8",
      "companyName": "Company Oy",
      "rightOfSignatureCode": "NIMA36"
      "rolesInCompany": [
        {
          "roleCode": "TJS",
          "roleStartDate": "2011-06-15"
        },
        {
          "roleCode": "PR",
          "signatureRuleCode": "NIMO01",
          "roleStartDate": "2011-06-15"
        },
        {
          "roleCode": "PJ",
          "roleStartDate": "2011-06-15"
        }
      ]
    },
    {
      "businessId": "1122334-5",
      "companyName": "Helsinki Productions Oy",
      "rightOfSignatureCode": "NIMA36"
      "rolesInCompany": [
        {
          "roleCode": "J",
          "roleStartDate": "2008-03-03"
        },
        {
          "roleCode": "TJ",
          "roleStartDate": "2008-03-03"
        }
      ]
    }
  ]
}

Retrieves person information and company relations by person key.

HTTP Request

GET https://api.taloustutka.fi/responsibleperson/<personKey>

Query Parameters

Parameter	Description
personKey	personKey of the person to retrieve

Response Values

Value name	Description
personKey	PersonKey of the person.
dateOfBirth	Birth date of the person.
firstNames	All first names of the person.
lastName	Last name of the person.
nationalityCode	Nationality of the person. See Nationality in Codes to get information about code.
domicile	Domicile of the person.
companyRelations	List of companies that the person has a role in.
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.
companyName	Name of the company.
rightOfSignatureCode	The company's right of signature code. See Right Of Signature in Codes, to get information about code.
rolesInCompany	List of roles that the person has in the company.
roleCode	Code of the role. See Company-Role in Codes, to get information about code.
signatureRuleCode	If the role in the company is procuration holder (roleCode PR), the signature rule code is included in the data. See Signature-Rule in Codes, to get information about code.
roleStartDate	Date of when the person started in this role.

Tutka

Recent Changes

curl "https://api.taloustutka.fi/v1.0/tutka/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "typeCategory": "NEWS_DATA",
    "changeDate": "2020-01-15"
  },
  {
    "typeCategory": "FINANCIAL_STATEMENT",
    "changeDate": "2019-03-28"
  },
  {
    "typeCategory": "REGISTER",
    "changeDate": "2019-06-18"
  },
  {
    "typeCategory": "CEO_HOUSE_MANAGER",
    "changeDate": "2020-01-10"
  },
  {
    "typeCategory": "RELIABLE_PARTNER",
    "changeDate": "2019-01-01"
  }
]

Retrieves a list which shows in which categories there have been changes for the company, and the date of when the new data became available.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
typeCategory	Category of what was changed. Possible values are RELIABLE_PARTNER, WEB_PAGE_CONTACT, NEWS_DATA, REGISTER, STATUS, MERGER_DEMERGER, FINANCIAL_STATEMENT, CEO_HOUSE_MANAGER, BOARD_MEMBER, OTHER_ROLE, SIGNATORY_RIGHTS, PUBLIC_TENDER, RATING, COMPANY_TYPE, LOCATION and COMPANY_NAME.
changeDate	Date when the new data became available.

Change data

Each type category can also be retrieved individually by using it in the endpoint path. The Tutka requests below retrieves changes that happened during the past 30 days, with specific data indicating what changes happened in queried company. The examples below document selected category-specific Tutka responses.

CEO / House Manager

curl "https://api.taloustutka.fi/v1.0/tutka/CEO_HOUSE_MANAGER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "IS",
      "changeType": "REMOVE",
      "personKey": "101010101"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "IS",
      "changeType": "REMOVE",
      "personKey": "202020202"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "IS",
      "changeType": "NEW",
      "personKey": "303030303"
    }
  }
]

Retrieves changes related to the company's CEO or house manager.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/CEO_HOUSE_MANAGER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
roleCode	Code of the role. See Company-Role in Codes to get more information about the code.
changeType	Type of the change. Possible values: NEW, REMOVE.
personKey	Person key of the person. See person key to get more information about the code.

Board Member

curl "https://api.taloustutka.fi/v1.0/tutka/BOARD_MEMBER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "VJ",
      "changeType": "REMOVE",
      "personKey": "101010101"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "VJ",
      "changeType": "NEW",
      "personKey": "202020202"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "J",
      "changeType": "REMOVE",
      "personKey": "202020202"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "J",
      "changeType": "NEW",
      "personKey": "303030303"
    }
  }
]

Retrieves changes related to the company's board members.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/BOARD_MEMBER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
roleCode	Code of the role. See Company-Role in Codes to get more information about the code.
changeType	Type of the change. Possible values: NEW, REMOVE.
personKey	Person key of the person. See person key to get more information about the code.

Other Role

curl "https://api.taloustutka.fi/v1.0/tutka/OTHER_ROLE/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "ELI",
      "changeType": "NEW",
      "personKey": "101010101"
    }
  }
]

Retrieves changes related to the company's other roles.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/OTHER_ROLE/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
roleCode	Code of the role. See Company-Role in Codes to get more information about the code.
changeType	Type of the change. Possible values: NEW, REMOVE.
personKey	Person key of the person. See person key to get more information about the code.

Signatory Rights

curl "https://api.taloustutka.fi/v1.0/tutka/SIGNATORY_RIGHTS/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "roleCode": "PR",
      "signatureRuleCode": "NIMP01",
      "changeType": "NEW",
      "personKey": "202020202"
    }
  }
]

Retrieves changes related to the company's signatory rights.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/SIGNATORY_RIGHTS/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
roleCode	Code of the role. See Company-Role in Codes to get more information about the code.
signatureRuleCode	Signature rule code included in the data. See Signature-Rule in Codes to get more information about the code.
changeType	Type of the change. Possible values: NEW, REMOVE.
personKey	Person key of the person. See person key to get more information about the code.

Reliable Partner Status

curl "https://api.taloustutka.fi/v1.0/tutka/RELIABLE_PARTNER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-10-08",
    "data": {
      "statusCode": "Tietoja odotetaan"
    }
  },
  {
    "changeDate": "2019-10-15",
    "data": {
      "statusCode": "Ok"
    }
  }
]

Retrieves changes in the status of the 'Luotettava kumppani'-certificate.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/RELIABLE_PARTNER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
statusCode	Reliable Partner status code. See Reliable Partner in Codes to get more information about the code.

Web Page Contact

curl "https://api.taloustutka.fi/v1.0/tutka/WEB_PAGE_CONTACT/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2020-02-04",
    "data": {
      "changeType": "NEW",
      "firstName": "Matt",
      "lastName": "Matson",
      "phoneNumber": "+358407516039",
      "email": "matt.matson@company.fi",
      "title": "Designer"
    }
  },
  {
    "changeDate": "2020-02-04",
    "data": {
      "changeType": "UPDATE",
      "firstName": "Jack",
      "lastName": "Jackson",
      "title": "Executive"
    }
  },
  {
    "changeDate": "2020-02-04",
    "data": {
      "changeType": "UPDATE",
      "firstName": "Ann",
      "lastName": "Smith",
      "title": "Executive"
    }
  },
  {
    "changeDate": "2020-02-04",
    "data": {
      "changeType": "NEW",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@company.fi"
    }
  }
]

Retrieves changes in contacts found from the specified company's website.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/WEB_PAGE_CONTACT/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: NEW, REMOVE, UPDATE.
firstName	First name of the contact.
lastName	Last name of the contact.
phoneNumber	Phone number of the contact.
email	Email of the contact.
title	Work title of the contact.

News

curl "https://api.taloustutka.fi/v1.0/tutka/NEWS_DATA/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2020-01-27",
    "data": {
      "title": "New product launched!",
      "url": "https://www.company.com"
    }
  },
  {
    "changeDate": "2020-01-26",
    "data": {
      "title": "Expanding overseas",
      "url": "https://www.news.fi"
    }
  }

Retrieves notices about articles, that were posted on the company's website. Also retrieves notices about articles that relate to the company and were posted on a major Finnish news publication.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/NEWS_DATA/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
title	Title of news
url	Url of the original news article.

Register

curl "https://api.taloustutka.fi/v1.0/tutka/REGISTER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-02-05",
    "data": {
      "changeType": "NEW",
      "registerType": "Kaupparekisteri"
    }
  },
  {
    "changeDate": "2019-08-05",
    "data": {
      "changeType": "REMOVE",
      "registerType": "Kaupparekisteri"
    }
  },
  {
    "changeDate": "2020-02-05",
    "data": {
      "changeType": "REMOVE",
      "registerType": "Ennakkoperintärekisteri"
    }
  }
]

Retrieves changes on the company's status in registers.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/REGISTER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: NEW, REMOVE. Indicates whether company was added or removed from the register in the change.
registerType	Specific register that the change is related to. Possible values: Ennakkoperintärekisteri, Kaupparekisteri, Työnantajarekisteri.

Company Status

curl "https://api.taloustutka.fi/v1.0/tutka/STATUS/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2020-02-04",
    "data": {
      "changeType": "REMOVE",
      "companyStatus": "BANKRUPT"
    }
  },
  {
    "changeDate": "2020-01-28",
    "data": {
      "changeType": "NEW",
      "companyStatus": "BANKRUPT"
    }
  }
]

Retrieves changes in the company's status.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/STATUS/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: NEW, REMOVE. Indicates was the status added or removed from the company.
companyStatus	Status of the company. Possible values: HALTED, BANKRUPT, DEPT_RESTRUCTURING, LIQUIDATION.

Mergers And Demergers

curl "https://api.taloustutka.fi/v1.0/tutka/MERGER_DEMERGER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-12-01",
    "data": {
      "changeType": "MERGED_INTO",
      "partial": false,
      "associatedCompanies": [
        "8765432-1"
      ]
    }
  },
  {
    "changeDate": "2019-10-01",
    "data": {
      "changeType": "ACQUIRED_FROM_MERGER",
      "partial": false,
      "associatedCompanies": [
        "1111111-8"
      ]
    }
  }
]

Retrieves mergers and demergers that the searched company has been part of.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/MERGER_DEMERGER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: MERGED_INTO, DEMERGED_INTO, ACQUIRED_FROM_MERGER, ACQUIRED_FROM_DEMERGER.
partial	Indicates whether only a part of a company merged/demerged.
associatedCompanies	List of business ids of the companies, that were associated with the searched company in the merger/demerger.

Change Types

Change type	Description
MERGED_INTO	The searched company merged into an another company or companies. Associated companies list tells which companies the searched company merged into.
DEMERGED_INTO	The searched company demerged into an another company or companies. Associated companies list tells which companies the searched company demerged into.
ACQUIRED_FROM_MERGER	Some other company or companies merged into the searched company. Associated companies list tells which companies merged into the searched company.
ACQUIRED_FROM_DEMERGER	Some other company or companies demerged into the searched company. Associated companies list tells which companies demerged into the searched company.

Financial Statement

curl "https://api.taloustutka.fi/v1.0/tutka/FINANCIAL_STATEMENT/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-17",
    "data": {
      "changeType": "NEW",
      "fiscalPeriodEndDate": "2018-12-31"
    }
  },
  {
    "changeDate": "2019-07-17",
    "data": {
      "changeType": "UPDATE",
      "fiscalPeriodEndDate": "2018-12-31"
    }
  },
  {
    "changeDate": "2019-09-17",
    "data": {
      "changeType": "FIX",
      "fiscalPeriodEndDate": "2018-12-31"
    }
  },
  {
    "changeDate": "2018-11-17",
    "data": {
      "changeType": "NEW",
      "fiscalPeriodEndDate": "2017-12-31"
    }
  }
]

Retrieves changes in the availability of financial statements.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/FINANCIAL_STATEMENT/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: NEW, UPDATE, FIX.
fiscalPeriodEndDate	End of the fiscal period.

Change type descriptions

Change type	Description
NEW	A new financial statement.
UPDATE	Change when company sent an updated version of a financial statement.
FIX	Errors in the financial statement values were fixed.

Public Tender

curl "https://api.taloustutka.fi/v1.0/tutka/PUBLIC_TENDER/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "projectTitle": "Laboratory equipment procurement 2026"
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "projectTitle": "Facility modernization project"
    }
  }
]

Retrieves changes related to public tenders involving the company.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/PUBLIC_TENDER/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
projectTitle	Title of the public tender project.

Rating

curl "https://api.taloustutka.fi/v1.0/tutka/RATING/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "changeType": "UPDATE",
      "previousRating": 3.5,
      "rating": 4.0
    }
  },
  {
    "changeDate": "2019-05-30",
    "data": {
      "changeType": "NEW",
      "rating": 3.0
    }
  }
]

Retrieves changes in the company's rating.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/RATING/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: NEW, UPDATE.
rating	Current rating value.
previousRating	Previous rating value (only present for UPDATE changeType).

Company Type

curl "https://api.taloustutka.fi/v1.0/tutka/COMPANY_TYPE/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "changeType": "UPDATE",
      "companyType": "OYJ",
      "previousCompanyType": "OY"
    }
  }
]

Retrieves changes in the company's type or form.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/COMPANY_TYPE/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: UPDATE.
companyType	Current company type code.
previousCompanyType	Previous company type code (only present for UPDATE changeType).

Location

curl "https://api.taloustutka.fi/v1.0/tutka/LOCATION/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "changeType": "UPDATE",
      "streetAddress": "Kauppakatu 15 A",
      "postalCode": "33100",
      "previousStreetAddress": "Teollisuuskatu 8",
      "previousPostalCode": "33200"
    }
  }
]

Retrieves changes in the company's location or address.

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/LOCATION/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: UPDATE.
streetAddress	Current street address.
postalCode	Current postal code.
previousStreetAddress	Previous street address (only present for UPDATE changeType).
previousPostalCode	Previous postal code (only present for UPDATE changeType).

Company Name

curl "https://api.taloustutka.fi/v1.0/tutka/COMPANY_NAME/1234567-8"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "changeDate": "2019-05-30",
    "data": {
      "changeType": "UPDATE",
      "addedNames": [
        "Tech Solutions Finland Oy"
      ],
      "removedNames": [
        "Digital Services Ltd"
      ]
    }
  }
]

Retrieves changes in the company's name(s).

HTTP Request

GET https://api.taloustutka.fi/v1.0/tutka/COMPANY_NAME/<businessId>

Query Parameters

Parameter	Description
businessId	Finnish business id (y-tunnus) of the company to retrieve the data from.

Response Values

Value name	Description
changeDate	Date when the new data became available.
data	Data object for this endpoint.
changeType	Type of the change. Possible values: UPDATE.
addedNames	List of company names that were added.
removedNames	List of company names that were removed.

Search

Search Company

Example 1: basic name search

curl -X POST "https://api.taloustutka.fi/v1.0/search/company" \
  -H 'x-api-key: abcDEF!?@123456' \
  -H 'Content-Type: application/json' \
  -d '{
    "parameters": [
      {"field": "name", "value": "Company"}
    ]
  }'

Example 2: multiple filters + page + responseValues

curl -X POST "https://api.taloustutka.fi/v1.0/search/company" \
  -H 'x-api-key: abcDEF!?@123456' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 0,
    "responseValues": [
      "personnelCount",
      "profitGrowthPercentage",
      "registers"
    ],
    "parameters": [
      {"field": "status", "value": "ACTIVE"},
      {"field": "location", "values": ["00100", "Kauniainen"]},
      {"field": "industry", "values": ["0144", "02"]},
      {"field": "revenue", "min": 1000000, "max": 5000000}
    ]
  }'

The above command returns JSON structured like this:

[
  {
    "businessId": "1234567-8",
    "name": "Company Oy",
    "location": "00100 Helsinki",
    "type": "OY",
    "industrySectorCode": "01440",
    "companyStatus": "ACTIVE",
    "tradeNames": [
      "Finnish Company",
      "Company Max"
    ],
    "revenue": 75000.00,
    "personnelCount": 23,
    "profitGrowthPercentage": 8.1,
    "registers": [
      "Kaupparekisteri",
      "Ennakkoperintärekisteri"
    ]
  }
]

Searches the top 500 matching companies. Results are returned in pages of 50 (10 pages total, page 0-9).

HTTP Request

POST https://api.taloustutka.fi/v1.0/search/company

Request Body

Company search parameters are defined in JSON request body.

Parameter name	Description
parameters	Required. List of search filters.
page	Optional. Result page index (0-9). Default 0.
responseValues	Optional. List of additional response fields to include. The first sortable value in this list determines sorting (descending).
sortField	Optional legacy sorting field. Used only when responseValues is not provided.
sortDirection	Optional legacy sort direction: ASC or DESC. Used only when responseValues is not provided.

Filter Fields

Each parameters item includes field and one of the value formats shown below.

Field name	Description	Input format	Accepts multiple values
name	Matches company primary name or trade names.	value	false
status	Matches company status. Possible values: ACTIVE, BUSINESS_ENDED, BANKRUPT, HALTED, LIQUIDATION, DEPT_RESTRUCTURING	value / values	true
location	Matches company location by postal code or county name.	value / values	true
industry	Matches an industry code (includes child industries). Input value must be an industry code.	value / values	true
taloustutkaStars	Filters Taloustutka star rating range.	min/max (or from/to)	false
revenue	Filters revenue range.	min/max (or from/to)	false
revenueGrowthPercentage	Filters revenue growth percentage range.	min/max (or from/to)	false
profitOfTheFinancialYear	Filters net profit of financial year range.	min/max (or from/to)	false
profitGrowthPercentage	Filters profit growth percentage range.	min/max (or from/to)	false
grossProfit	Filters gross profit range.	min/max (or from/to)	false
personnelCount	Filters personnel count range (integer values).	min/max (or from/to)	false
personnelGrowthPercentage	Filters personnel growth percentage range.	min/max (or from/to)	false
establishedDate	Filters company establishment date range.	minDate / maxDate (yyyy-MM-dd)	false
registers	Matches companies in selected registers. Allowed values: Arvonlisäverorekisteri, Kaupparekisteri, Ennakkoperintärekisteri, Työnantajarekisteri, Edunsaajarekisteri.	value / values	true
technologies	Matches company technologies.	value / values	true
country	Matches selected country values.	value / values	true
additionalLocations	Matches additional company locations.	value / values	true
capitalInvested	Filters invested capital range.	min/max (or from/to)	false
capitalAndReserves	Filters equity / capital and reserves range.	min/max (or from/to)	false
balance	Filters balance sheet total range.	min/max (or from/to)	false

Sorting Behavior

• If responseValues is provided, the API sorts by the first sortable value in responseValues (descending).
• registers and technologies are not sortable, so they are skipped when determining sorting.
• If responseValues is not provided, legacy sorting is used:
  • sortField + optional sortDirection
  • default: revenue descending

Response Values

The following fields are always part of search response:

Value name	Description
businessId	Finnish business ID (y-tunnus).
name	Company name.
location	Postal code and county (or one of them if the other is unknown).
type	Company type. Example values: OY, OYJ, KY.
industrySectorCode	Company industry code. See Industry in Codes.
companyStatus	Company status.
tradeNames	Auxiliary and parallel company names.
revenue	Revenue in previous fiscal period.

Additional fields are returned only when included in responseValues:

Value name	Description
revenueGrowthPercentage	Revenue growth percentage.
taloustutkaStars	Taloustutka star rating.
profitOfTheFinancialYear	Net profit of the financial year.
profitGrowthPercentage	Profit growth percentage.
grossProfit	Gross profit.
personnelCount	Personnel count.
personnelGrowthPercentage	Personnel growth percentage.
establishedDate	Company establishment date.
capitalInvested	Invested capital.
capitalAndReserves	Capital and reserves (equity).
balance	Balance sheet total.
registers	List of registers where company is included.
technologies	List of company technologies.

Search Company Technologies

Use this endpoint to search technology values found in Taloustutka. Returned technologies can be used with field: "technologies" in /search/company.

Example request

curl -X POST "https://api.taloustutka.fi/v1.0/search/company/technologies" \
  -H 'x-api-key: abcDEF!?@123456' \
  -H 'Content-Type: application/json' \
  -d '{"technology": "java"}'

The above command returns JSON structured like this:

[
  "JavaScript Modules",
  "Java EE",
  "Javascript",
  "PayPal JavaScript SDK",
  "Microsoft Authentication Library for JavaScript",
  "Javascript Defer",
  "GoLive Javascript",
  "Java Servlet",
  "Javascript Tooltips",
  "JavaServer Faces",
  "AWS SDK for JavaScript",
  "Bit.ly Javascript API",
  "JavaScript MVC",
  "Sun Java System",
  "Your Javascript",
  "Javanese",
  "Javanese HREF LANG",
  "Ninjavan",
  "JavaDoc"
]

Returns up to 500 technologies containing the given search string (case-insensitive).

HTTP Request

POST https://api.taloustutka.fi/v1.0/search/company/technologies

Request Body

Parameter name	Description
technology	Required search string. Must be non-empty and max 255 characters.

Response Values

Value	Description
string[]	Array of matching technology strings.

Search People

Example request

curl -X POST "https://api.taloustutka.fi/v1.0/search/people" \
  -H 'x-api-key: abcDEF!?@123456' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 0,
    "parameters": [
      {"field": "company", "value": "Company"},
      {"field": "role", "values": ["TJ", "PJ"]},
      {"field": "location", "values": ["00100", "Helsinki"]},
      {"field": "birthYear", "min": 1970, "max": 1990}
    ]
  }'

The above command returns JSON structured like this:

[
  {
    "firstName": "Matti",
    "lastName": "Meikalainen",
    "companyRoles": [
      {
        "companyRole": {
          "companyName": "Company Oy",
          "role": "TJ",
          "title": "Toimitusjohtaja",
          "phone": "+358401234567",
          "email": "matti.meikalainen@company.fi",
          "revenue": 7500000.00,
          "operatingProfitPercentage": 9.8,
          "personnelCount": 42
        }
      }
    ]
  }
]

Searches the top 500 matching people. Results are returned in pages of 50 (10 pages total, page 0-9).

Results are sorted by the revenue of the company the person has a role in (descending).

HTTP Request

POST https://api.taloustutka.fi/v1.0/search/people

Request Body

Parameter name	Description
parameters	Required. List of people search filters.
page	Optional. Result page index (0-9). Default 0.

Filter Fields

Each parameters item includes field and one of the value formats shown below.

Field name	Description	Input format	Accepts multiple values
company	Matches company business ID (prefix) or company name/trade names.	value	false
location	Matches company location by postal code or location value.	value / values	true
country	Matches person's country values.	value / values	true
status	Matches company status. Possible values: ACTIVE, BUSINESS_ENDED, BANKRUPT, HALTED, LIQUIDATION, DEPT_RESTRUCTURING	value / values	true
industry	Matches company industry code (prefix match).	value / values	true
revenue	Filters company revenue range.	min/max (or from/to)	false
operatingProfitPercentage	Filters company operating profit percentage range.	min/max (or from/to)	false
personnelCount	Filters company personnel count range (integer values).	min/max (or from/to)	false
role	Matches person role code in company (for example TJ, PJ).	value / values	true
jobArea	Matches role occupation category.	value / values	true
title	Matches role title / occupation.	value / values	true
contactInformation	If true, only returns roles with contact information (EMAIL or PHONE).	value (true / false)	false
birthYear	Filters person birth year range.	min/max (or from/to)	false

Response Values

Value name	Description
firstName	Person first name.
lastName	Person last name.
companyRoles	List of matching company-role entries for the person.
companyRoles[].companyRole.companyName	Company name.
companyRoles[].companyRole.role	Company role code.
companyRoles[].companyRole.title	Role title / occupation.
companyRoles[].companyRole.phone	Phone number in company role (when available).
companyRoles[].companyRole.email	Email in company role (when available).
companyRoles[].companyRole.revenue	Company revenue (used for sorting).
companyRoles[].companyRole.operatingProfitPercentage	Company operating profit percentage (when available).
companyRoles[].companyRole.personnelCount	Company personnel count (when available).

Search People Titles

Use this endpoint to search title values found in Taloustutka. Returned titles can be used with field: "title" in /search/people.

Example request

curl -X POST "https://api.taloustutka.fi/v1.0/search/people/titles" \
  -H 'x-api-key: abcDEF!?@123456' \
  -H 'Content-Type: application/json' \
  -d '{"title": "toimitus"}'

The above command returns JSON structured like this:

[
  "Toimitusjohtaja",
  "Toimitusjohtajan sijainen",
  "Apulaistoimitusjohtaja"
]

Returns up to 500 titles containing the given search string (case-insensitive).

HTTP Request

POST https://api.taloustutka.fi/v1.0/search/people/titles

Request Body

Parameter name	Description
title	Required search string. Must be non-empty and max 255 characters.

Response Values

Value	Description
string[]	Array of matching title strings.

Business Environment Data

Industry Medians

curl "https://api.taloustutka.fi/v1.0/medians/32/2017"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "year": 2017,
  "financialStatementCount": 776,
  "assetsTotal": 98961.77,
  "currentRatio": 2.18,
  "capitalAndReserves": 29456.66,
  "equityRatio": 51.55,
  "incomeBeforeExtraordinaryItemsPercentage": 6.34,
  "netGearing": -23.13,
  "netProfitPercentage": 3.37,
  "netWorkingCapitalPercentage": 24.68,
  "ebitda": 4726.91,
  "profitOfTheFinancialYear": 1578.34,
  "operatingProfit": 2129.65,
  "operatingProfitPercentage": 4.32,
  "operatingProfitGrowthPercentage": 7.35,
  "revenue": 118767.66,
  "revenueGrowthPercentage": -1.78,
  "returnOnInvestment": 7.12,
  "netProfit": 1511.98,
  "ebitdaPercentage": 7.74,
  "averageSalary": 2761.96,
  "staffExpenses": -64321.23
}

This endpoint is used to retrieve median key figures for the given second or third level industry. Year is a optional parameter. Year defaults to the year that was 20 months ago.

HTTP Request

GET https://api.taloustutka.fi/v1.0/medians/<industryCode>/<year> or

GET https://api.taloustutka.fi/v1.0/medians/<industryCode>

Query Parameters

Parameter	Description
industryCode	All industry codes with exactly two or three digits; e.g. 01, 32 or 412.
year (Optional)	The fiscal end-year for the financial statements that are used to calculate the medians.

Response Values

Value name	Description
year	The fiscal end-year for the financial statements that are used to calculate the medians.
financialStatementCount	Count of the financial statements that were used to calculate the median.

Complete list of response value fields, and their names in Finnish/Swedish, can be found here.

Data Codes

Industry

curl "https://api.taloustutka.fi/v1.0/codes/industry/01"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "01",
  "parentCode": "A",
  "finnish": "Kasvinviljely ja kotieläintalous, riistatalous ja niihin liittyvät palvelut",
  "english": "Crop and animal production, hunting and related service activities",
  "swedish": "Jordbruk och jakt samt service i anslutning härtill",
  "numberOfCompanies": 12345
}

Retrieves information of the industry by code. Taloustutka uses industry codes defined by Tilastokeskus (TOL 2025). The industry tree can also be found from here.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/industry/<industryCode>

Query Parameters

Parameter	Description
industryCode	Code of the industry

Response Values

Value name	Description
code	Code of the industry
parentCode	Parent industry code of the industry. Top level industries do not have a parent industry.
finnish	Finnish name of the industry.
english	English name of the industry.
swedish	Swedish name of the industry.
numberOfCompanies	Number of active companies under the given industry code level (the industry itself and all of its child industries).

All Industries

curl "https://api.taloustutka.fi/v1.0/codes/industry/"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "A",
    "finnish": "Maatalous, metsätalous ja kalatalous",
    "english": "AGRICULTURE, FORESTRY AND FISHING",
    "swedish": "JORDBRUK, SKOGSBRUK OCH FISKE"
  },
  {
    "code": "01",
    "parentCode": "A",
    "finnish": "Kasvinviljely ja kotieläintalous, riistatalous ja niihin liittyvät palvelut",
    "english": "Crop and animal production, hunting and related service activities",
    "swedish": "Jordbruk och jakt samt service i anslutning härtill"
  },
  {
    "code": "011",
    "parentCode": "01",
    "finnish": "Yksivuotisten kasvien viljely",
    "english": "Growing of non-perennial crops",
    "swedish": "Odling av ett- och tvååriga växter"
  },
  {
    "code": "0111",
    "parentCode": "011",
    "finnish": "Viljakasvien (pl. riisin), palkokasvien ja öljysiemenkasvien viljely",
    "english": "Growing of cereals (except rice), leguminous crops and oil seeds",
    "swedish": "Odling av spannmål (utom ris), baljväxter och oljeväxter"
  }...
]

Leaving the industry code unspecified, gives a list of all industry code explanations (~1800 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/industry

Response Values

Value name	Description
code	Code of the industry
parentCode	Parent industry code of this industry. Top level industries do not have a parent industry.
finnish	Finnish name of the industry.
english	English name of the industry.
swedish	Swedish name of the industry.

Company Role

curl "https://api.taloustutka.fi/v1.0/codes/role/TJ"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "TJ",
  "finnish": "Toimitusjohtaja",
  "english": "Managing Director",
  "swedish": "Verkställande direktör"
}

Retrieves code explanation of a company role by code.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/role/<roleCode>

Query Parameters

Parameter	Description
roleCode	Code of the industry

Response Values

Value name	Description
code	Code of the company role
finnish	Finnish name of the company role.
english	English name of the company role.
swedish	Swedish name of the company role.

All Company Roles

curl "https://api.taloustutka.fi/v1.0/codes/role"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "YHMÄ",
    "finnish": "Äänetön yhtiömies",
    "english": "Silent partner",
    "swedish": "Tysta bolagsman"
  },
  {
    "code": "VPJ",
    "finnish": "Varapuheenjohtaja",
    "english": "Vice-chairperson",
    "swedish": "Vice ordförande"
  },
  {
    "code": "PJ",
    "finnish": "Puheenjohtaja",
    "english": "Chairperson",
    "swedish": "Ordförande"
  }...
]

Leaving the company role code unspecified, gives a list of all company role code explanations (~30 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/role

Response Values

Value name	Description
code	Code of the company role
finnish	Finnish name of the company role.
english	English name of the company role.
swedish	Swedish name of the company role.

Nationality

curl "https://api.taloustutka.fi/v1.0/codes/nationality/FI"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "FI",
  "finnish": "Suomen kansalainen",
  "english": "Citizen of Finland",
  "swedish": "finsk medborgare"
}

Retrieves code explanation of a nationality by code.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/nationality/<nationalityCode>

Query Parameters

Parameter	Description
nationalityCode	Code of the nationality

Response Values

Value name	Description
code	Code of the nationality
finnish	Finnish name of the nationality.
english	English name of the nationality.
swedish	Swedish name of the nationality.

All Nationalities

curl "https://api.taloustutka.fi/v1.0/codes/nationality"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "AI",
    "finnish": "Anguillan kansalainen",
    "english": "Citizen of Anguilla",
    "swedish": "Anguillas medborgare"
  },
  {
    "code": "PR",
    "finnish": "Puerto Ricon kansalainen",
    "english": "Citizen of Puerto Rico",
    "swedish": "puertoricansk medborgare"
  },
  {
    "code": "PT",
    "finnish": "Portugalin kansalainen",
    "english": "Citizen of Portugal",
    "swedish": "portugisisk medborgare"
  }...
]

Leaving the nationality code unspecified, gives a list of all nationality code explanations (~250 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/nationality

Response Values

Value name	Description
code	Code of the nationality
finnish	Finnish name of the nationality.
english	English name of the nationality.
swedish	Swedish name of the nationality.

Signature Rule

curl "https://api.taloustutka.fi/v1.0/codes/signaturerule/NIMO01"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "NIMO01",
  "finnish": "Oikeutetut edustavat yhtiötä kukin yksin.",
  "english": "Representation by the persons authorised thereto as follows: on his or her own.",
  "swedish": "De berättigade företräder bolaget var för sig ensam."
}

Retrieves code explanation of a signature rule by code. The signature rule explains how does the signature of the person legally represent the company. Read more about the signature rule from here.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/signaturerule/<signatureRuleCode>

Query Parameters

Parameter	Description
signatureRuleCode	Code of the signature rule.

Response Values

Value name	Description
code	Code of the signature rule.
finnish	Finnish explanation of the signature rule.
english	English explanation of the signature rule.
swedish	Swedish explanation of the signature rule.

All Signature Rules

curl "https://api.taloustutka.fi/v1.0/codes/signaturerule"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "NIMP15",
    "finnish": "Prokuristit edustavat yhtiötä kaksi yhdessä tai kukin erikseen yhdessä hallituksen jäsenen tai isännöitsijän kanssa.",
    "english": "Representation by the holders of a procuration as follows: by two jointly, or by any of them jointly with any Board member or the House Manager.",
    "swedish": "Prokuristerna företräder bolaget två gemensamt eller var för sig gemensamt med en styrelsemedlem eller disponenten."
  },
  {
    "code": "NIMO39",
    "finnish": "Oikeutetut edustavat yhtiötä kaksi yhdessä tai kukin erikseen yhdessä hallituksen jäsenen, varajäsenen, toimitusjohtajan tai toimitusjohtajan sijaisen kanssa. ",
    "english": "Any two of the persons authorised thereto represent the company jointly, or each individually together with a member of the board of directors, a deputy member, the managing director, or the substitute for the managing director.",
    "swedish": "De berättigade företräder bolaget två tillsammans eller var för sig tillsammans med en styrelseledamot, en ersättare för en styrelseledamot, verkställande direktören eller ställföreträdaren för verkställande direktören. "
  }...
]

Leaving the signature rule code unspecified, gives a list of all signature rule code explanations (~80 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/signaturerule

Response Values

Value name	Description
code	Code of the signature rule.
finnish	Finnish explanation of the signature rule.
english	English explanation of the signature rule.
swedish	Swedish explanation of the signature rule.

Right Of Signature

curl "https://api.taloustutka.fi/v1.0/codes/rightofsignature/NIMA36"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "NIMA36",
  "finnish": "Hallituksen jäsen yhdessä hallituksen puheenjohtajan tai toimitusjohtajan kanssa",
  "english": "By any Board member jointly with the Chair of the Board or the Managing Director",
  "swedish": "Styrelsens ordförande och styrelsemedlem gemensamt eller verkställande direktören och styrelsemedlem gemensamt"
}

Retrieves code explanation of a right of signature by code. The right of signature explains how do the signatures of the board members of the company legally represent the company. Read more about the right of signature from here.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/rightofsignature/<rightOfSignatureCode>

Query Parameters

Parameter	Description
rightOfSignatureCode	Code of the company right of signature.

Response Values

Value name	Description
code	Code of the right of signature.
finnish	Finnish explanation of the right of signature.
english	English explanation of the right of signature.
swedish	Swedish explanation of the right of signature.

All Right Of Signatures

curl "https://api.taloustutka.fi/v1.0/codes/rightofsignature"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "NIMA40",
    "finnish": "Toimitusjohtaja ja hallituksen jäsen yhdessä, hallituksen puheenjohtaja ja hallituksen jäsen yhdessä tai hallituksen jäsenet kaksi yhdessä",
    "english": "The Managing Director and a member of the Board jointly, the Chairperson of the Board and a Board member jointly or any two Board members jointly",
    "swedish": "Verkställande direktören och en styrelseledamot tillsammans, styrelsens ordförande och en styrelseledamot tillsammans eller två styrelseledamöter tillsammans"
  },
  {
    "code": "NIMA43",
    "finnish": "Toimitusjohtaja ja hallituksen puheenjohtaja yhdessä, toimitusjohtaja ja hallituksen jäsen yhdessä tai hallituksen puheenjohtaja ja hallituksen jäsen yhdessä",
    "english": "The Managing Director and the Chairperson of the Board of Directors jointly, the Managing Director and a Board member jointly or the Chairperson of the Board and a Board member jointly",
    "swedish": "Verkställande direktören och styrelsens ordförande tillsammans, verkställande direktören och en styrelseledamot tillsammans eller styrelsens ordförande och en styrelseledamot tillsammans"
  }...
]

Leaving the right of signature code unspecified, gives a list of all right of signature code explanations (~70 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/rightofsignature

Value name	Description
code	Code of the right of signature.
finnish	Finnish explanation of the right of signature.
english	English explanation of the right of signature.
swedish	Swedish explanation of the right of signature.

Reliable Partner

curl "https://api.taloustutka.fi/v1.0/codes/reliablepartner/FI"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "code": "OK",
  "finnish": "Tietolähteiden perusteella yritys on hoitanut tilaajavastuulain edellyttämät velvoitteet.",
  "english": "According to the information sources, the company has met the obligations of the Contractor's Liability Act.",
  "swedish": "Enligt informationskällorna har företaget skött sina förpliktelser enligt beställaransvarslagen."
}

Retrieves code explanation of a Reliable Partner status by code. Read more about Reliable Partner from here.

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/reliablepartner/<reliablePartnerCode>

Query Parameters

Parameter	Description
reliablePartnerCode	Code of the Reliable Partner status

Response Values

Value name	Description
code	Code of the Reliable Partner status.
finnish	Finnish explanation of the Reliable Partner status.
english	English explanation of the Reliable Partner status.
swedish	Swedish explanation of the Reliable Partner status.

All Reliable Partner Codes

curl "https://api.taloustutka.fi/v1.0/codes/reliablepartner"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

[
  {
    "code": "STOP",
    "finnish": "Tietolähteiden perusteella yrityksen tilaajavastuutiedot eivät ole kunnossa!",
    "english": "According to the information sources the company's information is not okay!",
    "swedish": "Enligt informationskällorna är företagets uppgifter inte i skick!"
  },
  {
    "code": "OK",
    "finnish": "Tietolähteiden perusteella yritys on hoitanut tilaajavastuulain edellyttämät velvoitteet.",
    "english": "According to the information sources, the company has met the obligations of the Contractor's Liability Act.",
    "swedish": "Enligt informationskällorna har företaget skött sina förpliktelser enligt beställaransvarslagen."
  }...
]

Leaving the Reliable Partner code unspecified, gives a list of all Reliable Partner code explanations (5 different codes).

HTTP Request

GET https://api.taloustutka.fi/v1.0/codes/reliablepartner

Response Values

Value name	Description
code	Code of the Reliable Partner status.
finnish	Finnish explanation of the Reliable Partner status.
english	English explanation of the Reliable Partner status.
swedish	Swedish explanation of the Reliable Partner status.

Usage

VAT Usage This Year

curl "https://api.taloustutka.fi/v1.0/usage/vats-this-year"
  -H 'x-api-key: abcDEF!?@123456'

The above command returns JSON structured like this:

{
  "periodStart": "2026-05-18",
  "periodEnd": "2027-05-18",
  "requestedVatCount": 3,
  "maxOverviews": 500,
  "remainingVatCount": 497
}

Retrieves VAT usage statistics for the current calendar year for the authenticated API key.

HTTP Request

GET https://api.taloustutka.fi/v1.0/usage/vats-this-year

Query Parameters

This endpoint does not use query parameters.

Response Values

Value name	Description
periodStart	Start date of the current usage period.
periodEnd	End date of the current usage period.
requestedVatCount	Amount of VAT overviews already requested during the current usage period.
maxOverviews	Maximum amount of VAT overviews allowed during the current usage period.
remainingVatCount	Amount of VAT overviews remaining for the current usage period.

HTTP Status Codes

Taloustutka API uses the following HTTP response status codes:

Status Code	Meaning
200	OK -- Valid request, and data was found.
204	No Content -- Valid request, but no data was found for query.
301	Moved Permanently -- Moved permanently. Check if there is a trailing slash.
400	Bad Request -- The request is invalid. Invalid query parameter format.
401	Unauthorized -- No api key entered.
403	Forbidden -- The api endpoint requested is not available at the user level.
404	Not Found -- No api endpoint for request.
429	Too Many Requests -- Too many requests are made.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Status codes in the range of 4xx and 5xx have a response body in the format of {"error": "..."} with a message explaining what went wrong.

Api Licenses

Taloustutka API offers 3 different license tiers for its users. The table below shows which queries are available with each license. Note that the Taloustutka API licenses are separate from Taloustutka web service licenses.

Queries	Silver	Gold	Platinum
Company Information	✔️	✔️	✔️
Personnel Information	❌	✔️	✔️
Tutka	❌	❌	✔️
Search	❌	❌️	✔️
Business environment data	✔️	✔️	✔️
Data Codes	✔️	✔️	✔️

MCP Licenses

MCP has the same plan structure as the API licenses (Silver, Gold, and Platinum), and the allowed queries are the same for each corresponding plan. MCP access is granted based on the Taloustutka web service license as follows:

• Gold Taloustutka license: No MCP access (customers can contact Taloustutka if they want MCP access)
• Platinum Taloustutka license: Gold MCP access
• Diamond Taloustutka license: Platinum MCP access

The table below shows which MCP queries are available with each Taloustutka license.

Queries	Gold	Platinum	Diamond
Company Information	❌	✔️	✔️
Personnel Information	❌	✔️	✔️
Tutka	❌	❌	✔️
Search	❌	❌	✔️
Business environment data	❌	✔️	✔️