Record types

In the list of records available for subscription, you can only view the record types that you can request based on your role.

The transcript or record is generated based on your subscription. It represents the situation at the time of generating the transcript or record.

New and corrected reports are not directly available in the transcript database, as data is usually updated there every hour. 

Payer’s transcripts and records

If your organisation has submitted data to the Incomes Register using a suborganisation identifier, you can limit the subscription by entering the suborganisation identifier.

You can download the requested transcripts in the e-service on the ‘Subscriptions made’ page.

Transcripts of earnings payment data

Read the instructions for the content of earnings payment transcripts:

The 600 transcript includes:

  • the number of reports;
  • amounts presented in earnings payment reports, including:
    • total payments;
    • income on which various insurance contributions are based;
    • amounts withheld;
    • unjust enrichment and recovery;
  • amounts presented in the employer’s separate reports;
    • the employer’s health insurance contributions;
    • deductions from payments.

The 600 (PDF) and 630 (CSV) transcripts include the same data. If you want to process a transcript in a spreadsheet program (such as Excel), request the 630 transcript.

Amounts are itemised based on the payment date, month and the entire time range, but not based on individual income earners or income types.

If you want to reconcile a transcript by income earner or income type, use the 618 transcript. 

Place a subscription and download

You can request transcripts in the e-service, upload service or technical interface. The time range can be at most 24 months.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

If you cannot use e-services

You can request transcripts using the paper form for a summary of a payer’s earnings payment data (600). The transcript will be sent by post.

The 630 transcript includes:

  • the number of reports;
  • amounts presented in earnings payment reports, including:
    • total payments;
    • income on which various insurance contributions are based;
    • amounts withheld;
    • unjust enrichment and recovery;
  • amounts presented in the employer’s separate reports;
    • the employer’s health insurance contributions;
    • deductions from payments.

The 630 (CSV) and 600 (PDF) transcripts include the same data. If you want to open a transcript in PDF format, request the 600 transcript.

Amounts are itemised based on the payment date, month and the entire time range, but not based on individual income earners or income types.

If you want to reconcile a transcript by income earner or income type, use the 618 transcript. 

Place a subscription and download

You can request transcripts in the e-service. The time range can be at most 24 months.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

The 618 transcript includes:

  • data presented in earnings payment reports, including:
    • identifiers of all income earners (personal identity code without the last four characters);
    • income types and types of insurance information given in conjunction with them and differing from the default;
    • information about income being an unjust enrichment or recovery;
    • exceptions to insurance.

The data is itemised based on the payment date, income earner and income type.

Place a subscription and download

You can request transcripts in the e-service. The time range can be at most one month.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

Transcript 634 consists of earnings payment report data related to absences, including

  • income earner’s name and identifier (personal identity code without the last four characters);
  • reported time periods for reporting absences, whether or not there were any absences during the period;
  • reported absence periods;
    • reason for each absence;
    • information about whether an absence was paid or unpaid, and wages paid during paid absences;
    • the estimated end date of an absence if the absence continues;
    • Kela’s reimbursement application data.

The 634 (PDF) and 636 (CSV) transcripts include the same data. If you want to process a transcript in a spreadsheet program (such as Excel), request the 636 transcript.

The data is itemised based on the income earner and payment date.

Place a subscription and download

You can request transcripts in the e-service. The time range of absences can be 31 days at the most.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

Transcript 636 consists of earnings payment report data related to absences, including

  • income earner’s name and identifier (personal identity code without the last four characters);
  • reported time periods for reporting absences, whether or not there were any absences during the period;
  • reported absence periods;
    • reason for each absence;
    • information about whether an absence was paid or unpaid, and wages paid during paid absences;
    • the estimated end date of an absence if the absence continues;
    • Kela’s reimbursement application data.

The 636 (CSV) and 634 (PDF) transcripts include the same data. If you want to open a transcript in PDF format, request the 634 report.

The data is itemised based on the income earner and payment date.

Place a subscription and download

You can request transcripts in the e-service. The time range of absences can be 31 days at the most.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

Records of earnings payment data

Read the instructions for the content of earnings payment records:

The 312 record includes:

  • the number of reports;
  • amounts presented in earnings payment reports, including:
    • total payments;
    • income on which various insurance contributions are based;
    • amounts withheld;
    • unjust enrichment and recovery.

Amounts are itemised based on the payment date. Amounts on each payment date are itemised further based on the income earner, pension policy number and occupational accident policy number.

If you want to reconciliate by income type, use the 618 transcript.

Place a subscription and retrieve

You can only request records if your organisation uses the SFTP API. The time range can be at most 12 months.

  • If you request a record regarding your organisation’s data, you can place the subscription through the e-service, upload service or technical interface.
  • If you request a record on behalf of another payer, your organisation will require the authorisation “Ordering and retrieving records related to the payer’s earnings payment data”. You can only place the subscription through the technical interface or upload service.

You can also make a recurrent subscription in the interface or upload service, in which case the record number is 313.

Retrieve records in XML format from your organisation’s SFTP folder.

Read more in the technical description of the 312 record

Read more about authorisation and how to grant it

Transcripts of benefits payment data

Read the instructions for the content of benefits payment transcripts:

The 614 transcript includes:

  • the number of reports;
  • amounts presented in benefits payment reports, including:
    • total payments;
    • deductions;
    • amounts withheld;
    • unjust enrichment and recovery.

The 614 (PDF) and 632 (CSV) transcripts include the same data. If you want to process a transcript in a spreadsheet program (such as Excel), request the 632 transcript.

Amounts are itemised based on the payment date, month and the entire time range, but not based on individual income earners or income types. Amounts are displayed separately for income earners who are resident and non-resident taxpayers.

If you want to reconcile a transcript in more detail by income earner or income type, use the 620 transcript. 

Place a subscription and download

You can request transcripts as a one-off subscription in the e-service, upload service or technical interface.

You can also make a recurrent subscription in the interface or upload service. In this case, the record number is 615.

The time range can be at most 24 months.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

The 632 transcript includes:

  • the number of reports;
  • amounts presented in benefits payment reports, including:
    • total payments;
    • deductions;
    • amounts withheld;
    • unjust enrichment and recovery.

The 632 (CSV) and 614 (PDF) transcripts include the same data. If you want to open a transcript in PDF format, request the 614 report.

Amounts are itemised based on the payment date, month and the entire time range, but not based on individual income earners or income types. Amounts are displayed separately for income earners who are resident and non-resident taxpayers.

If you want to reconcile a transcript in more detail by income earner or income type, use the 620 transcript. 

Place a subscription and download

You can request transcripts in the e-service. The time range can be at most 24 months.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

The 620 transcript includes:

  • data presented in benefits payment reports, including:
    • the names and identifiers of all income earners;
    • income types and their additional information, including taxability.

The data is itemised based on the payment date, income earner and income type.

Place a subscription and download

You can request transcripts in the e-service. The time range can be at most one month.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

Other payer’s transcripts

These transcripts are shared by earnings and benefits payment data.

The 610 transcript includes:

  • the number of approved and rejected reports;
    • by report type;
    • by delivery channel;
  • the total number of errors detected on the reports;
  • error codes, their descriptions and the number of each error.

The data is shown regarding reports submitted via the technical interface or the upload service. With the transcript, you can monitor any errors in reporting.

Place a subscription and download

You can request transcripts as a one-off subscription in the e-service, upload service or technical interface.

You can also make a recurrent subscription in the interface or upload service. In this case, the record number is 611.

The time range can be at most one month.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

The 612 transcript includes:

  • data about actions that individuals acting on the payer’s behalf have taken in the Incomes Register’s e-service, including:
    • searching for or browsing reports;
    • reporting, correcting or cancelling;
  • data about the e-service view each individual has accessed.

With the transcript, you can check how your organisation has used the e-service. The transcript can be requested for a single individual or all.

Placing a subscription and retrieving the transcript

The subscription is placed in the Incomes Register’s telephone service.

The transcript can only be requested by an individual authorised to sign for the organisation. The time range can be at most three months.

The transcript will be sent by post.

Data user’s records and transcripts

Your organisation’s data access profile determines what Incomes Register data you can access.

If you defined several query parameters in your subscription, they will be used simultaneously. For example, if you define the time range and earnings-related pension provider code as query parameters for the record, only the reports that include the pension provider code in question will be selected in the record over the time range.

Data user’s records

These instructions present the records data users can request in the e-service. You can retrieve the requested records from your organisation’s SFTP folder.

The record will include earnings payment reports of all income earners.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

You can also select that no reports, on which the payer is a substitute payer, are selected for the record.

Retrieve the record in XML format from your organisation’s SFTP folder.

You can limit the query by entering the earnings-related pension provider code. The record will include all earnings payment reports that include this pension provider code.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

You can also select that no reports, on which the payer is a substitute payer, are selected for the record.

Retrieve  the record in XML format from your organisation’s SFTP folder.

The record will include the earnings payment reports with no earnings-related pension policy number.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

You can filter the query by entering information about an earnings-related pension policy in the ‘Pension Insurance Act’ section. You can also select that no reports, on which the payer is a substitute payer, are selected for the record.

Retrieve the record in XML format from your organisation’s SFTP folder.

The employer’s separate reports regarding all payers are selected for the record.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

Retrieve the record in XML format from your organisation’s SFTP folder.

You can limit the query by entering the earnings-related pension provider code. The record will include all employer’s separate reports that include this pension provider code.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

Retrieve the record in XML format from your organisation’s SFTP folder.

The record includes

  • data about actions, such as searching for and browsing data, that individuals acting on the organisation’s behalf have taken in the Incomes Register’s e-service;
  • data about the e-service view each individual has accessed.

With the record, you can check how your organisation has used the e-service. The time range can be at most one month.

Retrieve the record in XML format from your organisation’s SFTP folder.

You can limit the query by entering Incomes Register report references (at most 200 references).

The record will include the earnings payment reports that include any of these references.

The Incomes Register report reference is a technical system reference in GUID format (e.g. 40c5d83b-b2f6-4f4c-8f95-51f9224c7388).

Retrieve the record in XML format from your organisation’s SFTP folder.

The record will include benefits payment reports of all income earners.

Define the time range of payment date or the query time range for changes as the query parameter. The time range of payment date only applies to this record, while the query time range for changes applies to the entire subscription. The time range can be at most one month.

Retrieve the record in XML format from your organisation’s SFTP folder.

You can limit the query by entering Incomes Register report references (at most 200 references).

The record will include the benefits payment reports that include any of these references.

The Incomes Register report reference is a technical system reference in GUID format (e.g. 40c5d83b-b2f6-4f4c-8f95-51f9224c7388).

Retrieve the record in XML format from your organisation’s SFTP folder.

Records 301, 302, 303, 307, 316, 317 and 319 you can request only in the SFTP API.

Data user’s transcripts

You can download the requested transcripts in the e-service on the ‘Subscriptions made’ page.

The transcript is intended for data users to monitor record subscriptions and queries made based on them.

The transcript includes:

  • the number of records queried for the data user;
  • the number of reports contained by records.

The data is itemised by record type.

You can request transcripts in the e-service, upload service or technical interface. The time range can be at most 12 months.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

With the transcript, you can check how your organisation has used the e-service.

The transcript includes

  • data about actions, such as searching for and browsing data, that individuals acting on the organisation’s behalf have taken in the Incomes Register’s e-service;
  • data about the e-service view each individual has accessed.

The 702 (PDF) and 710 (CSV) transcripts include the same data. If you want to process a transcript in a spreadsheet program (such as Excel), request the 710 transcript.

You can request transcripts in the e-service, upload service or technical interface. The time range can be at most 3 months.

The transcript can be requested for a single individual or all. You can enter a specific individual’s personal identity code in the ‘User ID’ section, in which case the transcript will only include information about the specific individual’s actions.

Download a transcript in PDF format on the ‘Subscriptions made’ page in the e-service.

With the transcript, you can check how your organisation has used the e-service.

The transcript includes

  • data about actions, such as searching for and browsing data, that individuals acting on the organisation’s behalf have taken in the Incomes Register’s e-service;
  • data about the e-service view each individual has accessed.

The 710 (CSV) and 702 (PDF) transcripts include the same data. If you want to open a transcript in PDF format, request the 702 report.

You can request transcripts in the e-service, upload service or technical interface. The time range can be at most 3 months.

The transcript can be requested for a single individual or all. You can enter a specific individual’s personal identity code in the ‘User ID’ section, in which case the transcript will only include information about the specific individual’s actions.

Download a transcript in CSV format on the ‘Subscriptions made’ page in the e-service.

Detailed information about records and transcripts

Detailed information about different record types is available in technical descriptions on the ‘Documentation’ page:

  • Calculation rules are specified in the document ‘Income data – Calculation rules’.
  • The data content of transcripts is presented in the document ‘Transcripts in the Incomes Register’.
  • The content of the payer’s transcript 312 is described in the document ‘Data distribution – Schemas – Summary of payer’s earnings payment data’.
  • The content of data user’s transcripts of the 300 series is described in the document ‘Technical interface – Distribution of data’.
Page last updated 11/16/2023