{"id":21452335,"url":"https://github.com/vtfk/azf-dsf","last_synced_at":"2025-10-04T16:31:35.177Z","repository":{"id":41982405,"uuid":"263314337","full_name":"vtfk/azf-dsf","owner":"vtfk","description":"Azure function for looking up residents in DSF (Det sentrale folkeregisteret)","archived":false,"fork":false,"pushed_at":"2024-12-19T15:20:39.000Z","size":513,"stargazers_count":0,"open_issues_count":12,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-19T16:28:15.896Z","etag":null,"topics":["det-sentrale-folkeregisteret","dsf","infotorg","node-dsf"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vtfk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-12T11:13:20.000Z","updated_at":"2022-01-08T13:38:25.000Z","dependencies_parsed_at":"2024-12-19T16:35:26.525Z","dependency_job_id":null,"html_url":"https://github.com/vtfk/azf-dsf","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtfk%2Fazf-dsf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtfk%2Fazf-dsf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtfk%2Fazf-dsf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtfk%2Fazf-dsf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vtfk","download_url":"https://codeload.github.com/vtfk/azf-dsf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235283285,"owners_count":18964955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["det-sentrale-folkeregisteret","dsf","infotorg","node-dsf"],"created_at":"2024-11-23T04:28:53.411Z","updated_at":"2025-10-04T16:31:34.755Z","avatar_url":"https://github.com/vtfk.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# azf-dsf\nAzure Function to lookup data from DSF (Det sentrale folkeregisteret) using [node-dsf](https://www.npmjs.com/package/node-dsf).\nDSF is register of residents in Norway.\n\nTo obtain login credentials and other permissions, please head over to [infotorg.no](https://www.infotorg.no/).\n\nInfotorg field descripton: [Funksjonell feltoversikt - Det sentrale folkeregister](https://www.infotorg.no/leveranse/integrasjonen/integrasjon-mot-folkeregisteret/_/attachment/download/f6d059b7-2098-491f-ba92-0ab2939ef084:f14d2e79b7f0e76c87ae136622d53ce9e43ed6ab/Funksjonell%20feltoversikt%20Det%20sentrale%20folkeregister%20v1-5.pdf)\n\nNot in use, but useful info: [Informasjonsmodell modernisert folkeregister](https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/informasjonsmodell/)\n\nValid test-objects are found here: [Oversikt over gyldige testobjekter](https://www.infotorg.no/leveranse/integrasjonen/integrasjon-mot-folkeregisteret)\n\n## Azure Function\n\n### **All calls need a valid JSON Web Token**\n\n### Application settings (``local.settings.json``):\n```json\n{\n  \"IsEncrypted\": false,\n  \"Values\": {\n    \"FUNCTIONS_WORKER_RUNTIME\": \"node\",\n    \"AzureWebJobsStorage\": \"\",\n    \"DSF_URL\": \"http://ws-test.infotorg.no/xml/ErgoGroup/DetSentraleFolkeregister1_4/2015-08-10/DetSentraleFolkeregister1_4.wsdl\",\n    \"DSF_MASS_URL\": \"http://ws-test.infotorg.no/xml/ErgoGroup/DSFMasseoppslag1_4/2015-08-10/DSFMasseoppslag1_4.wsdl\",\n    \"DSF_NAMESPACE\": \"http://ws.infotorg.no/xml/Admin/Brukersesjon/2006-07-07/Brukersesjon.xsd\",\n    \"DSF_DIST\": \"PTP\", \n    \"DSF_SYSTEM_NAVN\": \"systemnavn\",\n    \"DSF_BRUKERNAVN\": \"brukernavn\",\n    \"DSF_PASSORD\": \"passord\",\n    \"JWT_SECRET\": \"Skikkelig hemmelig secret\",\n    \"PAPERTRAIL_DISABLE_LOGGING\": false,\n    \"PAPERTRAIL_HOST\": \"https://logs.collector.solarwinds.com/v1/log\",\n    \"PAPERTRAIL_TOKEN\": \"hgbegpgnq4gbnpq49glbpuqpqgpqgqeøå9eqor\",\n    \"E18_URL\": \"https://e18url.net\", // optional\n    \"E18_KEY\": \"secret token\", // optional\n    \"E18_SYSTEM\": \"dsf\", // optional\n    \"E18_EMPTY_JOB\": true // optional\n  }\n}\n```\n\n### E18\n\nTo support [E18](https://github.com/vtfk/e18-node#usage), add `E18_URL`, `E18_KEY` and `E18_SYSTEM`\n\n## API\n\n**Actual address will not be returned for persons with these SPES-KD codes**:\n- **4**: *KLIENTADRESSE*\n- **5**: *UTEN FAST BO.*\n- **6**: *SPERRET ADRESSE, STRENGT FORTROLIG*\n- **7**: *SPERRET ADRESSE, FORTROLIG*\n\n**Actual address will not be returned for persons with these STAT-KD codes**:\n- **5**: *DØD*\n- **8**: *ANNULLERT TILGANG*\n- **9**: *Uregistrert*\n\n**Actual address will not be returned when**:\n- *STAT* **is** *UTVANDRET*\n- *ADRL* **is defined (has address outside of Norway)**\n\n### POST ```/lookup```\n\n**Request**\n```json\n{\n  \"method\": \"hentDetaljer\",\n  \"query\": {\n    \"saksref\": \"your-reference\",\n    \"internalref\": \"your-internal-reference\", // optional if you want an internal reference logged out with the request\n    \"foedselsdato\": \"01013300239\"\n  }\n}\n```\n\nSee valid test data on [infotorg.no](https://qa.infotorg.no/test/cms/site/0/page?id=77)\n\n**Response**\n```json\n{\n  \"RESULT\": {\n    \"HOV\": {\n      \"FODT\": \"010133\",\n      \"PERS\": \"00239\",\n      \"INR\": \"01013300309\",\n      \"FODTAR\": \"1933\",\n      \"STAT-KD\": \"1\",\n      \"STAT\": \"BOSATT\",\n      \"NAVN-S\": \"Mo\",\n      \"NAVN-F\": \"Irene\",\n      \"NAVN-M\": \"Fos\",\n      \"NAVN\": \"Mo Irene Fos\",\n      \"NAVN-D\": null,\n      \"ADRR\": \"19971001\",\n      \"ADRF\": \"19971001\",\n      \"ADR\": \"Etterstad\",\n      \"POSTN\": \"0603\",\n      \"POSTS\": \"OSLO\",\n      \"KOMNR\": \"0018\",\n      \"KOMNA\": \"REFKOM1\",\n      \"GARD\": \"00018\",\n      \"BRUK\": \"0018\",\n      \"ADRTYPE\": \"M\",\n      \"INVF\": \"106\",\n      \"INVF-N\": \"SVERIGE\",\n      \"INVF-R\": \"19911031\",\n      \"INVF-F\": \"19911031\",\n      \"FKOM\": \"0019\",\n      \"FKOM-N\": \"REFKOM2\",\n      \"FKOM-R\": \"19971001\",\n      \"FKOM-F\": \"19971001\",\n      \"UTVT\": null,\n      \"UTVT-N\": null,\n      \"UTVT-R\": null,\n      \"UTVT-F\": null,\n      \"AARSADR\": \"26\",\n      \"SPES-KD\": \"0\",\n      \"SPES\": \"VANLIG BOSATT\",\n      \"SKKR\": \"0001\",\n      \"VAKR\": \"0001\",\n      \"MELD\": \"\",\n      \"SIVS-KD\": \"5\",\n      \"SIVS\": \"SEPARERT\",\n      \"Statsborgerskap\": [\n        {\n          \"STATB-KD\": \"000\",\n          \"STATB\": \"NORSK\"\n        }\n      ],\n      \"KJONN\": \"K\",\n      \"AARSNVN\": \"02\",\n      \"FODKNR\": \"106\",\n      \"FODK\": \"SVERIGE\",\n      \"FODS\": null,\n      \"FNR\": \"01013300239\",\n      \"bostedsAdresse\": {\n        \"ADR\": \"Etterstad\",\n        \"POSTN\": \"0603\",\n        \"POSTS\": \"OSLO\"\n      },\n      \"postAdresse\": {\n        \"ADR\": \"Etterstad\",\n        \"POSTN\": \"0603\",\n        \"POSTS\": \"OSLO\"\n      }\n    }\n  }\n}\n```\n\n### POST ```/lookup``` for mass lookups\n\n**Request**\n```json\n{\n  \"method\": \"hentDetaljer\",\n  \"massLookup\": true,\n  \"query\": {\n    \"saksref\": \"your-reference\",\n    \"internalref\": \"your-internal-reference\", // optional if you want an internal reference logged out with the request\n    \"foedselsdato\": \"010133\",\n    \"etternavn\": \"Mo\",\n    \"fornavn\": \"Irene\"\n  }\n}\n```\n\n**Response**\n```json\n{\n  \"RESULT\": {\n    \"HOV\": {\n      \"FODT\": \"010133\",\n      \"PERS\": \"00239\",\n      \"INR\": \"01013300309\",\n      \"FODTAR\": \"1933\",\n      \"STAT-KD\": \"1\",\n      \"STAT\": \"BOSATT\",\n      \"NAVN-S\": \"Mo\",\n      \"NAVN-F\": \"Irene\",\n      \"NAVN-M\": \"Fos\",\n      \"NAVN\": \"Mo Irene Fos\",\n      \"NAVN-D\": null,\n      \"ADRR\": \"19971001\",\n      \"ADRF\": \"19971001\",\n      \"ADR\": \"Etterstad\",\n      \"POSTN\": \"0603\",\n      \"POSTS\": \"OSLO\",\n      \"KOMNR\": \"0018\",\n      \"KOMNA\": \"REFKOM1\",\n      \"GARD\": \"00018\",\n      \"BRUK\": \"0018\",\n      \"ADRTYPE\": \"M\",\n      \"INVF\": \"106\",\n      \"INVF-N\": \"SVERIGE\",\n      \"INVF-R\": \"19911031\",\n      \"INVF-F\": \"19911031\",\n      \"FKOM\": \"0019\",\n      \"FKOM-N\": \"REFKOM2\",\n      \"FKOM-R\": \"19971001\",\n      \"FKOM-F\": \"19971001\",\n      \"UTVT\": null,\n      \"UTVT-N\": null,\n      \"UTVT-R\": null,\n      \"UTVT-F\": null,\n      \"AARSADR\": \"26\",\n      \"SPES-KD\": \"0\",\n      \"SPES\": \"VANLIG BOSATT\",\n      \"SKKR\": \"0001\",\n      \"VAKR\": \"0001\",\n      \"MELD\": \"\",\n      \"SIVS-KD\": \"5\",\n      \"SIVS\": \"SEPARERT\",\n      \"Statsborgerskap\": [\n        {\n          \"STATB-KD\": \"000\",\n          \"STATB\": \"NORSK\"\n        }\n      ],\n      \"KJONN\": \"K\",\n      \"AARSNVN\": \"02\",\n      \"FODKNR\": \"106\",\n      \"FODK\": \"SVERIGE\",\n      \"FODS\": null,\n      \"FNR\": \"01013300239\",\n      \"bostedsAdresse\": {\n        \"ADR\": \"Etterstad\",\n        \"POSTN\": \"0603\",\n        \"POSTS\": \"OSLO\"\n      },\n      \"postAdresse\": {\n        \"ADR\": \"Etterstad\",\n        \"POSTN\": \"0603\",\n        \"POSTS\": \"OSLO\"\n      }\n    }\n  }\n}\n```\n\n## Related\n- [node-dsf](https://github.com/telemark/node-dsf) Node.js module for looking up data from DSF (Det sentrale folkeregister)\n\n## License\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvtfk%2Fazf-dsf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvtfk%2Fazf-dsf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvtfk%2Fazf-dsf/lists"}