Data search for data users
In the e-service, you can search for and view data that your organisation has the right to access and you are authorised to view.
How to search for data
You can search for data using search criteria or references. Always limit the search to be as specific as possible to find the data you are looking for.
1
Select search method
If you use search criteria, the required search criteria are preselected. Please select more specific search criteria whenever possible.
- The data user role affects which search criteria are required.
- The search criteria you select may affect which additional search criteria you can or must use.
If you use the reference search, you can search for a specific report using the Incomes Register’s report reference.
- When using certain data user roles, the identifier of the payer or income earner must be given as a search criterion in addition to the reference.
2
Fill in the required fields
Fill in the information required for the search and select Search.
- The report search may take a moment. If a search is in progress and you return to modify the search criteria, the current search will be completed first. A new search will not start until after that.
- If required information is missing or the information you have filled in is incorrect, you will receive an error message.
3
Browse search results
You will receive a summary of the reports that match your search. The page also displays the search criteria used in the search.
- The summary shows the totals of the different report types and the reported income types.
- Types of income are broken down into the following specific items, if the reports have the relevant data and if you are authorised to access the data:
- the amounts reported of unjust enrichment and recovery, specifically for the type of income concerned, appearing under the income type
- the amounts of taxes withheld, and tax-at-source withheld, being part of the amount being recovered, appearing under that amount.
- The summary is only displayed if there are at most 2,000 search results. If there are more search results, more specific search criteria are required.
Use the search criteria to refine your search
Your data user role affects which reports can be searched for and which search criteria can be used. All the search criteria available to you are visible in the e-service.
You can remove search criteria by clicking X in the top right-hand corner. You can remove all search criteria by clicking “Clear”.
“Time range” and “Type of time range” are always mandatory.
- Select the start and end date of the time range from the calendar.
- Also select the type of time range.
You can also add several time ranges by selecting Add time range.
This narrows down the search. For example, if you select 1–15 October as the time range for the payment or reporting date and 1–20 October as the time range for the reception timestamp, only reports that match both time ranges will be searched for.
Time range type
By default, the payment or reporting date is set as the time range type. You can use the following time range types:
- Reception timestamp: The time when the report was saved in the Incomes Register.
- Payment or reporting date: The payment date or reporting date indicated in the report.
- Earnings period: The period over which the income has been accrued as indicated in the report.
- Absence period (earnings payment report): The continuous absence period of the income earner indicated in the earnings payment report.
- Reporting period (employer’s separate report): The reporting period is the calendar month indicated in the employer’s separate report, to which the data is allocated.
- Combination search: wages and benefits: The combination search is only available to certain data user roles. If you select the combination search, the search criterion is the payment date on earnings payment reports, the reporting date on the employer’s separate reports, and the earnings period on benefits payment reports.
Income earner’s identifier
You can filter your search using the income earner’s identifier.
- Select the type of identifier (e.g. personal identity code) from the drop-down menu and add the identifier.
- If you select “No personal identity code” or “No business ID”, enter the person’s name and date of birth or the company’s name. A country code must also be entered for foreign identifiers.
- If you are searching by an income earner’s name, the report will only appear in the search results if it does not include the income earner’s identifier.
Please note that each report is always searched separately. For example, if an income earner has one report without an identifier, another report with the identifier type “Other identifier” and a third one with a Finnish personal identity code, you must carry out three searches to find all three reports and gain an overall picture of the individual’s income.
Employment relationships
You can filter your search based on the duration of the employment relationship.
- Select to add employment relationship information and enter the start and end dates of the employment relationship.
The search results include all reports where the employment relationship is valid on at least one day within the period you have entered.
If you only enter the start date of the employment relationship, the search results will include all the reports where the employment relationship is valid on at least one day after the start date.
Please note that the time range is always used as a search criterion.
Occupational class
You can filter your search based on the income earner’s occupational class. Add the occupational class type and identifier. Search results only include earnings payment reports.
Report status
You can search for reports submitted to the Incomes Register based on the report status.
- Valid: The search results will only include reports that are valid. Cancelled reports or previous versions of corrected reports will not be included in the search results.
- All versions: The search results will include all reports submitted to the Incomes Register, including cancelled reports and previous versions of corrected reports.
- Cancelled: The search results will only include reports that have been cancelled in the Incomes Register.
If you do not select the report status as a search criterion, Valid will be used as the default status.
Report type
You can filter search results by selecting the report types that you want to search for from the Incomes Register.
Payer identifier
You can filter your search by entering the payer’s identifier type and identifier. Select the type of identifier from the drop-down menu and add the identifier.
The search will cover the reports, on which the payer has been indicated as the payer, actual employer, or substitute payer.
If you are searching by a payer’s name, the report will only appear in the search results if it does not include the payer identifier.
Substitute payer
You can filter your search by selecting “No reports where the payer is a substitute payer”.
The search will only retrieve reports, on which the payer has been indicated as the payer or actual employer. Any reports, on which the payer is the substitute payer, will be excluded from the search.
You can filter the search by entering the following information:
- insurance obligation
- earnings-related pension insurance (earnings-related pension policy number)
- occupational accident insurance policy number.
You can filter your search using the Incomes Register’s income types.
When using the search criterion “Payments made”, enter a time range that is as short as possible. If there are too many search results, the search will be interrupted, and an error message will appear.
Wage income types
- First, select which report type you are searching for, i.e. the income types in the earnings payment report or the employer’s separate report.
- Then, add the income type code.
You can also search for the employer’s separate reports that state “No wages payable”.
Benefit income types
- First, select benefits payment report as the report type.
- Then, add the income type code.
You can search for benefits payment reports that include details for one or more additional income types. You can use this search criterion with or without an income type.
Searching for absence data?
You can only search for and browse absence data in a specific data user role. You cannot browse income data in the same role.
Select the search method and fill in the required fields
Use search criteria to search for data.
- The required search criteria “Time range” and “Payer” or “Income earner” are preselected under “Selected search criteria”.
- You can also filter your search by selecting report status, report type or insurance information as search criteria.
Enter the payer or income earner’s identifier as search criteria.
- Select “Absence period (earnings payment report)” as the time range and enter the start and end dates of the absence period.
- Finally, select Search.
- The search results will only include reports that include absence data.
You can also search by time range under “Payment or reporting date”. In that case, the search results will show all reports for that period, regardless of whether they include reported absence periods.
Review the search results
When you select “Reports with absence data” in the search results to view
- earnings payment reports with absences reported
- earnings payment reports stating that there have been no absences, i.e. the time period for reporting absences has been reported.
The e-service is meant for submitting single reports or small report batches.
The service displays the reports as a list and does not generate compilations or a downloadable file. In other words, you cannot transfer data to, for example, spreadsheet or text processing programmes.
You can browse the search results in the service one report at a time. For large amounts of data, we recommend using a technical API through which you can order the data as a record and process it in your own software.
You can search for data using search criteria or references. Always limit the search to be as specific as possible to find the data you are looking for.
You can select multiple search criteria
Select the search criteria based on the purpose of the data.
If you know that a search will return a large number of reports, you can filter the search, for example, by shortening the search time range or by entering more specific search criteria.
The retrieved reports are displayed from the latest to the oldest. You can change the order by clicking the column header.
Once you have viewed the report data and returned to the search results list, the row of the opened report is highlighted in blue and italics. Row highlighting is session-specific and role-specific. If you close the browser or switch data user roles, the highlighting will no longer appear.
Reference search allows you to search for a specific report
If you are looking for a specific report and you know the Incomes Register report reference, search by the reference to find the report in question.
The Incomes Register report reference is a technical system reference in GUID format (e.g. 40c5d83b-b2f6-4f4c-8f95-51f9224c7388).
A special role authorisation is needed to view the wages paid by the organisation.
If you are searching for the earnings payment data of an individual working in your organisation with the income earner’s identifier and you have not been assigned the special role “Wages paid by own organisation”, then you can only view payments made by other payers. The wages paid by your organisation do not appear in the search results, so you may not gain an overall picture of the individual’s income during the search period.
If you are searching for your organisation’s reports by the organisation’s business ID, and you have not been assigned the special role “Wages paid by own organisation”, a message stating “No search results” will appear in the e-service.
If you need the earnings payment data reported by your organisation for your job, the organisation’s master user must authorise you to act as a data user and assign you the special role “Wages paid by own organisation”. The e-service does not state that you need a special role to access the data.
If you are unsure whether you have been assigned this special role, please contact your organisation’s master user. If necessary, the master user can check your authorisations.
A decision may be made for the income earner of a new benefit that is granted partially for the same period as the previously paid benefit. In such cases, the previously paid pension or benefit will not be recovered; instead, it may be considered a partial payment of the benefit to be paid later.
The benefit payer reports the retroactive change to the benefit with a replacement report. The payer does not correct the original income type, but adds the information “Income type changed, new income type code” and enters the new income type code.
If the data user does not have the right to access data for the new income type, the search results will show the technical code 9999 instead of the correct income type code. This provides the data user with sufficient data for their decision-making even when the income type has been changed to one which the user is not authorised to access.
If the data user organisation does not have the data access right to any of the income types reported in the benefits payment report, a blank report is displayed in the benefits payment report list. The blank report row contains the following message in the details column: “There are no income types for distribution”.
Only the Incomes Register report reference, the report version number, the time of receipt of the first version of the report, the time of record creation, and the Incomes Register record reference are displayed.
Blank report filtering is a feature of the data access profile that allows only the mandatory technical data of blank reports included in the search results to be viewed.
Filtering is only available in those data access profiles for which the Incomes Register and the sector have agreed to use it. The use of filtering is mentioned in the data user organisation’s data permission.
Page last updated 5/13/2026