VTJkysely-rajapinta 

VTJkysely-rajapinnan kautta julkisen tai yksityisen sektorin organisaatio voi hakea väestöjärjestelmän reaaliaikaisia tietoja suoraan omaan tietojärjestelmäänsä. 

VTJkysely-rajapinnan kautta organisaatio voi hakea väestöjärjestelmän tietoja reaaliaikaisesti omassa tietojärjestelmässään käsiteltäväksi.  

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. 

VTJkysely-rajapinta ei ole tarkoitettu oman rekisterin tietojen säännölliseen tai laajamittaiseen päivittämiseen tai muihin massamuotoisiin kyselyihin. Tällaiseen tarpeeseen 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 VTJkysely-rajapinnan tekninen toteutus ja käyttö -sivulta

Vaihtoehtona omalle suoralle VTJkysely-rajapintayhteydelle voit tiedustella VTJ-tietoihin pohjautuvia palveluita myös yrityksiltä, joille on myönnetty oikeus edelleenvälittää VTJkysely-rajapinnan kautta haettuja tietoja. Tällöin lupakäsittely voi olla kevyempää ja nopeampaa. 

Muistilista ennen asiointia 

Toimi näin 

Ennen palveluun rekisteröitymistä tutustu Digi- ja väestötietoviraston palveluihin ja verkkoasioinnin käyttöehtoihin asiakassivustollamme

Hae tietolupa verkkoasioinnissa

  1. Mene verkkoasiointiin

  1. a) Jos olet jo rekisteröitynyt asiakastilin käyttäjäksi, kirjaudu sisään rekisteröityessäsi 
    antamallasi sähköpostiosoitteella ja salasanalla tai suomi.fi-tunnistautumisen kautta. Mikäli et muista salasanaasi, paina ”Unohditko salasanasi” -linkkiä. 
    b) Jos et ole vielä rekisteröitynyt asiakastiliin käyttäjäksi, paina Rekisteröidy-painiketta. 

  1. Kirjauduttuasi sisään valitse verkkoasioinnin yläpalkista ”Aloita uusi hakemus” -osio. 

  1. Valitse välilehdistä, edustatko julkishallinnon organisaatiota vai yritystä tai yhteisöä. 

  1. Valitse seuraavaksi kohta, jossa lukee ”Haluan hakea tietoja väestötietojärjestelmästä”. 

  1. Valitse avautuvasta valikosta ”VTJ-rajapinnan tietolupahakemus” ja paina Aloita-painiketta. 

  1. Täydennä hakemuksen tiedot. Voit lähettää lomakkeen käsiteltäväksi vasta, kun kaikki tarvittavat kentät on täytetty. Tarkista, että kaikkien kenttien yhteydessä näkyy vihreä symboli, joka ilmaisee, että kenttä on täytetty oikein. 

  1. Tarkista lopuksi antamasi tiedot ja paina ”Lähetä DVV:lle” -painiketta. 

Mikäli tarvitset apua tietolupahakemuksen tekemisessä, esimerkiksi haettavan tietosisällön tarkassa määrittelemisessä, ota yhteyttä 

Kunnat, sosiaali- ja terveystoimen kuntayhtymät sekä sairaanhoitopiirit voivat tilata palvelun verkkoasioinnissa hieman kevennetyllä menettelyllä, sillä niillä on toistaiseksi voimassa oleva kattolupa VTJkysely-rajapintaan. Tilauksen yhteydessä on täytettävä selvitys tietojen suojauksesta ja käytöstä sekä käyttöoikeushakemuksen hallintapalveluista. 

Kuntien, sosiaali- ja terveystoimen kuntayhtymien sekä sairaanhoitopiirien kattolupa- ja tuotekuvaukset. 

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. 

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.  

Usein kysytyt kysymykset