PIS modified data interface
The PIS modified data interface is suitable for updating large public administration person registers. The service is particularly suitable for situations in which keeping data up to date is important. The PIS modified data interface will replace the modified data update service by the 30th of June 2026.
The PIS modified data interface is used to update organisations’ registers with changes recorded in the population data. The customer can choose the update interval of the data. Due to the flexible update interval, keeping the data up to date is also more efficient than in the previous modified data update service. For example, the update interval can be once a day.
Data can be retrieved from the PIS modified data interface using several different criteria:
- Personal data can be retrieved by personal identity codes.
- Municipalities, hospital districts and joint municipal authorities can retrieve personal data updates by the municipality.
- The authorities that keep a national register can have their own customised retrieval criteria for updating personal data.
In connection with the commissioning of the service, the agreed basic data on all persons in the register will be relayed to the customer organisation's register.
Test interface
To demonstrate and test the PIS modified data interface, a so-called sandbox websiteLink to an external website, Opens in a new tabyja-external-link-opens-in-a-new-tab (in Finnish) has been made available. The service does not require signing in and is freely available to customers and software developers.
The data in the sandbox does not contain real personal data. The personal identity codes and other personal data are test materials. The data can be used for various service development tasks and for testing the service. The test personal identity codes starting with the number 9 are never real persons' personal identity codes.
Follow these instructions
If the organisation has previously been a user of the modified data update service, the format and relay method of the data will change when switching to the PIS modified data interface. It also requires changes to the technical implementation by which the customer's register is updated.
A sequential file similar to the current modified data update service will be delivered until the 30th of June 2026. Until then, the current modified data update service will operate alongside the new service. No changes other than those brought about by legislative changes will be made to the old modified data update service, and it is not offered to new users.
Commissioning the PIS modified data interface
The PIS modified data interface's data is relayed through the Digital and Population Data Services Agency's Suomi.fi Data Exchange Layer. Read more about the Data Exchange Layer.Link to an external website, Opens in a new tabyja-external-link-opens-in-a-new-tab
The commissioning of the PIS modified data interface is done by applying for a data access authorisation in the Digital and Population Data Services Agency's e-servicesLink to an external website, Opens in a new tabyja-external-link-opens-in-a-new-tab. When placing an order for the service, a report on data protection arrangements and the purpose for the use of the data must be provided.
Frequently asked questions
Yes, the new PIS modified data interface service will replace the old service after a transition period.
No changes will be made to the old modified data update service, and it is not offered to new users. Basic data sets can still be ordered to the old service. After the transition period, the old service will no longer be available.
VTJ-muutosrajapinnan käyttöönottomaksu on 1000 euroa per yhteys.
- Käyttöönottomaksua ei veloiteta silloin, kun nykyisen Muutostietopalvelun asiakas siirtyy uuden VTJ-muutosrajapinnan käyttäjäksi. Jos päivitettäväksi tulee useita rekistereitä eri yhteyksien kautta, veloitetaan käyttöönottomaksu jokaisesta uudesta yhteydestä.
Palvelun käyttö on käyttöönoton jälkeen maksutonta Valtiovarainministeriön maksuasetuksen 1136/2021 2 §:ssä (linkki) mainituille valtion ja kuntien viranomaisille.
Tietoyksikköhinta veloitetaan niiltä asiakkailta, jotka eivät ole oikeutettuja maksuttomaan palveluun.
- Muutostietojen tietoyksikköhinta on 0,036 euroa per tietue.
The same personal data and building data from the Population Information System as in the current modified data update service are relayed through the service. Data is relayed by data category according to the need for use and the granted authorisation.
- Tietojenvälitys tapahtuu REST-rajapinnan kautta.
- Uusi välitysreitti on Suomi.fi-palveluväylä.
- Uusi aineistoformaatti on JSON.
- Palvelussa on UTF-8 merkistön tuki.
Kyllä, tietojen päivitysrytmi on voi olla tiheämpi, ja tietojen ajantasaisuus on siten parempi. Päivitysrytmi on joustava, ja asiakas voi itse valita, kuinka usein hakee rekisteriinsä päivityksiä. Tietoja voidaan hakea esimerkiksi kerran vuorokaudessa tai kerran tunnissa.
- Henkilötietoja voidaan hakea henkilötunnuksilla. Asiakas voi lisätä päivitykseen omassa rekisterissään olevia henkilöitä henkilötunnuksen perusteella.
- Kunnat, sairaanhoitopiirit ja kuntayhtymät voivat hakea henkilötietojen päivityksiä kuntarajauksen perusteella.
- Valtakunnallista rekisteriä pitäville viranomaisille voidaan räätälöidä poimintaehtoja, joilla henkilöiden tietoja päivitetään.
Uuteen palveluun siirryttäessä tietoluvat uusitaan. Asiakas tekee verkkoasioinnin kautta hakemuksen uudesta tietoluvasta.
Kunnille, kuntayhtymille ja hyvinvointialueille on myönnetty yhteinen kattolupa saada tietoja viranomaistehtävien hoitoon, jolloin käyttäjäorganisaatiot voivat tilata tietoja luvan puitteissa.
Hakemus tai tilaus tehdään Digi- ja väestötietoviraston verkkoasioinnin kautta. Palvelun käyttölupaan liittyvät kysymykset voi lähettää osoitteella muutostietopalvelu@dvv.fiyja-external-link-opens-in-a-new-tab
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä niin sanottu hiekkalaatikko-sivusto. Palvelu ei vaadi kirjautumista ja on vapaasti asiakkaiden ja ohjelmistokehittäjien käytettävissä.
Tietoja voi käyttää erilaisiin palvelunkehitystehtäviin ja palvelun testaamiseen. Tiedot eivät sisällä oikeita henkilötietoja, vaan henkilötunnukset ja muut henkilötiedot ovat testiaineistoja. Testihenkilötunnukset, jotka alkavat numerolla 9, eivät koskaan ole oikeiden henkilöiden henkilötunnuksia vaan testitunnuksia.
Links to Acts
Laki väestötietojärjestelmästä ja Digi- ja väestötietoviraston varmennepalveluistaLink to an external website, Opens in a new tabyja-external-link-opens-in-a-new-tab (661/2009), Act on the Population Information System and the Certificate Services of the Digital and Population Data Services Agency