Ajankohtaista

♦ Digi- ja väestötietovirasto on antanut uuden VTJkysely-rajapinnan liiketaloudellisia hintoja koskevan päätöksen, joka astui voimaan 1.1.2025. Lataa uusi liiketaloudellinen hinnasto tästä.

VTJkysely-rajapinta

VTJkysely-rajapinnan kautta organisaatio voi hakea väestöjärjestelmästä yksittäisiä, reaaliaikaisia tietoja suoraan omaan tietojärjestelmäänsä, organisaation työntekijöiden käyttöön.

VTJkysely-rajapinta sopii organisaatiolle, joka haluaa esimerkiksi

tarkistaa asiakkaiden perustietoja
tarjota omille asiakkailleen sähköisen asioinnin palveluita
tarkistaa tietojen oikeellisuutta hakemusten käsittelyprosesseissa.

Organisaation käyttöön luovutettavista VTJ-tiedoista ja niiden käyttötarkoituksesta sovitaan aina tapauskohtaisesti Digi- ja väestötietoviraston kanssa.

Digi- ja väestötietovirasto palvelee julkisen sektorin organisaatioita.

Välittäjäyritykset palvelevat yksityisen sektorin organisaatioita.

VTJkysely-rajapinta välittäjäyrityksille.

Liity häiriötiedotelistalle

Häiriötiedotelistalla oleviin sähköpostiosoitteisiin tiedotetaan mahdollisista häiriöistä VTJkysely-rajapinnassa. Ilmoittaudu tästä.

Hyvä tietää

► Vaihtoehtona VTJkysely-rajapinnalle on VTJkysely-selainsovellus. Tämä verkkoselaimessa toimiva palvelu tarjoaa helppokäyttöisen tavan hyödyntää tietoja ilman rajapintaintegraatiota.

► VTJkysely-rajapinta ei saa käyttää oman rekisterin tietojen säännölliseen tai laajamittaiseen päivittämiseen tai muihin massamuotoisiin kyselyihin. Tällaisiin tarpeisiin soveltuvat Digi- ja väestötietoviraston asiakasrekisterien päivityspalvelut julkishallinnolle ja yksityisille yrityksille ja yhteisöille.

► VTJkysely-rajapinnasta haetaan ja vastaanotetaan tietoja XML-muotoisina sanomina. Tarkempaa tietoa rajapinnan teknisestä toteutuksesta löydät sivulta VTJkysely-rajapinnan tekninen toteutus.

Muistilista ennen asiointia

Tutustu väestötietojen käytön edellytyksiin.
Tutustu tekniseen toteutukseen.
VTJkysely-rajapinnan käyttöönotto edellyttää että julkisen sektorin organisaatiolla on käytössään Suomi.fi-palveluväylä. Ohje Suomi.fi-palveluväylän käyttöönottoon. Muut toimijat voivat käyttää Suomi.fi-palveluväylää tai palvelinvarmennetta.

Käsittelyaika

VTJkysely-rajapinnan tietolupahakemuksen käsittelyaika on noin kolme kuukautta. Käsittelyaika sisältää hakemuksen täydennyspyynnöt, neuvottelut ja teknisen järjestelmän arvioinnin.

Tietojen käyttö, lokitus ja valvonta

VTJkyselystä saatavia väestötietojärjestelmän tietoja saa käyttää vain tietolupapäätöksessä mainittuihin työ- ja virkatehtäviin. Tietojen käyttö tai katselu henkilökohtaisiin tarkoituksiin on ehdottomasti kielletty. Kaikessa tietojen käsittelyssä tulee noudattaa huolellisuutta ja hyvää tietojenkäsittelytapaa tietosuoja ja tietoturva huomioiden.

Väestötietojärjestelmän tiedot eivät ole julkisia, eikä tietoja saa luovuttaa sivullisille.

Luvansaajan vastuulla on ylläpitää lokitiedostoa, johon tallennetaan kaikki väestötietojärjestelmään tehdyt kyselyt. Lokitiedostoja on säilytettävä pääsääntöisesti viiden (5) vuoden ajan. Lokitiedostosta tulee ilmetä kuka on tehnyt kyselyn (henkilötasolla), mitä tietoja väestötietojärjestelmästä on kysytty, ja milloin kysely on tehty (pp.kk.vvvv klo).

Digi- ja väestötietovirasto seuraa ja valvoo, miten VTJkyselyä käytetään. Mahdollisia seurauksia VTJkyselyn väärinkäytöksistä ovat esimerkiksi huomautus organisaatiolle VTJ-tietojen käsittelyyn liittyen tai organisaation tietoluvan päättäminen. Vakavammissa tapauksissa seurauksena on rikosilmoitus. Jos luvansaaja epäilee väärinkäyttöä omassa organisaatiossaan, luvansaajan on oltava yhteydessä Digi- ja väestötietovirastoon viipymättä.

Digi- ja väestötietovirastolla on oikeus tarvittaessa tarkistaa lokitiedosto väestötietojärjestelmän kyselyiden osalta. Luvansaajan tulee pyydettäessä antaa DVV:lle selvitys tietojen käytöstä viivytyksettä.

Hinta

VTJkysely-rajapinnan käyttö on maksutonta kunnan ja valtion viranomaisille sekä hyvinvointialueille.
Muille lakisääteistä tehtävää suorittaville julkissektorin asiakkaille sekä yksityissektorin asiakkaille VTJkysely-rajapinnan käyttö laskutetaan kuukausittain tehtyjen kyselyiden määrään perusteella.
Julkissektorin asiakkailta veloitetaan lisäksi VTJkysely-rajapinnan perustamismaksu.

Yrityksille ja yhteisöille VTJkysely-rajapinnan kautta tehtävät kyselyt ovat maksullisia. Kunkin kyselyn hinta riippuu muun muassa tietosisällön laajuudesta. Myös yhteyden perustamiskustannukset peritään asiakasorganisaatiolta.

VTJkyselyn-rajapinnan kyselyt ovat maksuttomia kunnan ja valtion viranomaisille sekä hyvinvointialueille, mutta palvelun käyttöönotosta peritään perustamismaksu.

Palvelun käyttöönotto

VTJkysely-rajapinnan perustamismaksu 600 euroa.

Muussa tapauksessa julkissektorin maksut:

Suppea kysely 0,041 euroa per kysely
Peruskysely 0,081 euroa per kysely
Laaja kysely 0,12 euroa per kysely
Tunnistuskysely 0,151 euroa per kysely

Yksityissektorin toimijoille palvelun käytöstä veloitettavat maksut määräytyvät halutun kysely-yhteyden tietosisällön mukaan.

Esimerkkihintoja yksityissektorin maksuista:
•   Minikysely 0,22 euroa per kysely
•   Peruskysely 0,33 euroa per kysely
•   Peruskysely muokattuna 0,49 euroa per kysely
•   Laaja kysely 0,61 euroa per kysely
•   Laaja kysely muokattuna 0,68 euroa per kysely
•   Rakennuksen tunnistuskysely 0,025 euroa per kysely
•   Rakennustiedot 0,252 euroa per kysely

VTJkysely-kyselyrajapinnan räätälöinnistä ja asiakkaalle räätälöityjen kyselyiden tekemisestä veloitetaan toteutuneiden kustannusten mukaan.

Liiketaloudellinen hinnasto 1.1.2025 alkaen (PDF)

Jos palvelu hankitaan välittäjäyrityksen kautta, antaa kyseinen välittäjäyritys lisätietoja hinnoista.

Usein kysytyt kysymykset

Verkkoselaimessa toimiva VTJkysely-selainsovellus tarjoaa helppokäyttöisen tavan hyödyntää tietoja ilman rajapintaintegraatiota. VTJkysely-rajapinnan käyttöönotto vaatii enemmän työtä kuin VTJkysely-selainsovelluksen käyttöönotto. Tämä johtuu siitä, että kyselyrajapinta vaatii tietojärjestelmän kehitystyötä sekä tietojen käsittelyn suojausta ja lokitusta.

Rajapinta kuitenkin mahdollistaa VTJ-tiedon joustavamman käsittelyn järjestelmässä, joka on rakennettu omaan käyttötarkoitukseenne sopivaksi. Tarkempaa tietoa näistä edellytyksistä ja velvoitteista löydät VTJkysely-rajapinnan tekninen toteutus -sivulta .

VTJkysely-rajapinnan käyttöönottoon, salasanoihin ja muihin teknisiin ongelmiin liittyvissä asioissa ota yhteyttä VTJkysely-rajapinnan yleisen sähköpostin kautta: