Skip to main content
Version: 1.0.1

Bruk av våre data

Finansportalen stiller sine data gratis til rådighet. Finansportalen samler inn renter og gebyrer for de fleste banker som opererer i Norge.

Dataene vi viser om verdipapirfond kjøper vi selv fra Oslo Børs Informasjon AS og Morningstar. For verdipapirfond og forsikringspriser, har vi derfor ikke data vi kan dele.

Våre data deles gjennom et REST-basert api med JSON formatert data.

For gratis tilgang til våre rådata, for bruk i eksterne applikasjoner, må man undertegne en distribusjonsavtale med oss. Når avtalen er inngått, så vil distributøren motta et brukernavn og passord, samt dokumentasjon om endepunkter.

Distribusjonsavtale med Finansportalen

For tilgang til våre data-feeder, må du inngå en distribusjonsavtale med Finansportalen. Vi har laget en standard avtaletekst, hvor de viktigste punktene er at vi ber deg love å ikke ta data ut av sin sammenheng, samt å holde dataene oppdaterte.

For initiering av distribusjonsavtale med Finansportalen, vennligst send en scan av signert avtale til e-post-adressen “support-fp@forbrukerradet.no”.

Standard Informasjonsdelingsavtale for finansportalen v3.1

Logo for distributører

Distributører skal benytte én av følgende “Data levert av Finansportalen” logoer:

Integrerbare sammenligningsverktøy

Alle sammenligningsverktøyene til Finansportalen er integrerbare. De kan inkluderes på eksterne nettsider, ved bruk av enkel HTML-kode (iFrame løsning). Disse “portable kalkulatorene” kan benyttes uten distribusjonsavtale, såfremt de kjøres som de er. Det er ikke tillatt å kopiere og manipulere kildekoden, eller benytte datafeeden til de portable kalkulatorene uten etter avtale med Finansportalen.

Kodeeksempler for integrering

Iframe med satt gitt høyde og bredde

Merk at høyden som benyttes vil måtte tilpasses verktøyet man integrerer

<iframe src="https://www.forbrukerradet.no/finansportalen/bank/iframe/lan/boliglan" 
title="Finansportalen – Boliglån"
width="100%" height="1400"
style="border:0;min-width:320px"
loading="lazy" referrerpolicy="no-referrer-when-downgrade"></iframe>

Levering av data fra Forbrukerrådets feed

Forbrukerrådets banktjeneste tilbyr en samling REST-endepunkter for maskinell levering av data. Endepunktene er dokumentert i Swagger her: https://finans-api.forbrukerradet.no/swagger/feed/

Autentisering

Alle endepunkter er beskyttet og krever et gyldig JWT access token, som må sendes som en Bearer-token i Authorization-headeren.

For å hente et access token, bruk /auth/token-endepunktet: https://finans-api.forbrukerradet.no/swagger/feed/#/Authentication/post_auth_token

Velg external_consumer som grantType. Fyll inn clientId og clientSecret som dere fått levert av Forbrukerrådet. Endepunktet returnerer blant annet et accessToken med 60 minutters levetid.

Bruk av access token

Ved kall til API-endepunktene skal access token sendes i HTTP-headeren slik:

Authorization: Bearer

Se Swagger-dokumentasjonen for detaljer om tilgjengelige endepunkter, parametre og datamodeller.

Eksempler med curl

Hente access token

curl -X POST "https://finans-api.forbrukerradet.no/auth/token" ^
-H "Content-Type: application/json" ^
-d "{
\"grantType\": \"external_consumer\",
\"clientId\": \"\",
\"clientSecret\": \"\"
}"

Dette vil gi et svar som inneholder blant annet accessToken.

Kalle et data-endepunkt med access token

Når du har fått tak i access token, kan du bruke det slik for å hente ut selskaper:

curl -X GET "https://finans-api.forbrukerradet.no/feed/banks" ^
-H "Authorization: Bearer "

Bytt ut med tokenet du fikk fra forrige steg.

Tips

Du finner mer informasjon om alle tilgjengelige endepunkter, parametre og datamodeller i Swagger-dokumentasjonen: https://finans-api.forbrukerradet.no/swagger/feed/