Versjon: 0.2.0

Bilforsikring

Dokumentasjon av API for bilforsikring-integrasjon med Forbrukerrådets forsikringstjeneste.

Forespørsel fra Forbrukerrådet

Når Forbrukerrådet sender en forespørsel til forsikringsselskapet, vil det være i JSON-format. Denne forespørselen inneholder informasjon om personen som skal forsikres, samt detaljer om det spesifikke tilbudet som er forespurt. Forespørselen vil bli sendt til angitt endepunkt hos selskapet.

Informasjonen om personen som skal forsikres, vil bygges basert på data fra Folkeregisteret, Statens Vegvesen og OFV.

I header vil vi sende med X-RequestId som er unik, og X-ClientId som vil være finansportalen.

Manglende sammenfall mellom Finansportalen Forsikring og Selskapenes verdigrenser

Der beløpsgrenser og verdier i Finansportalen Forsikrings kalkulator må velges som alternativer i brukergrensesnittet, og Forsikringsforetaket ikke opererer med de samme grensene i sine pristariffer, skal Forsikringsforetaket likevel returnere pris. Prisen skal returneres i form av nærmeste verdi til kundens gunst, for eksempel nærmeste pris ved nærmeste høyere kjørelengde.

Eksempel på forespørsel

{
    "id": "xtNczK2rUAh5lfz-i26iO",
    "person": {
        "pid": "10816797409",
        "firstName": "FORETAKSOM",
        "lastName": "KONGE",
        "addresses": [
            {
                "source": "folkeregisteret",
                "streetName": "Munkerekkveien 110",
                "postalCode": "3142",
                "postalLocation": "VESTSKOGEN"
            }
        ],
        "memberships": [
            {
                "membershipId": "821395476",
                "membershipName": "Norske Arkitekters Landsforbund"
            }
        ]
    },
    "offerRequest": [
        {
            "id": "iKiLHD0opex6UcUqxyL3j",
            "type": "bil",
            "data": {
                "coverage": "kasko",
                "addons": [
                    "leiebil",
                    "maskinskade"
                ],
                "bonus": "75%",
                "yearlyMileage": 12000,
                "youngestDriver": 25,
                "loan": false,
                "currentMileage": 50000,
                "currentAccidents": 1,
                "lastAccidentDate": "2023-02-05",
                "deductible": 6000,
                "carOwner": {
                    "ownerType": "otherOwner",
                    "leasingCompanyOrg": null,
                    "otherOwner": {
                        "pid": "09916795316",
                        "firstName": "FJÅNG",
                        "lastName": "REGEL"
                    }
                },
                "car": {
                    "source": "ofv",
                    "registrationDate": "2022-01-01",
                    "variantId": 385869,
                    "modelYear": 2022,
                    "brandName": "Audi",
                    "brandCode": 1230,
                    "modelName": "A4",
                    "modelCode": 9,
                    "variantName": "Avant Advanced 35 TFSi 150hk",
                    "variantCode": 21193,
                    "vehicleGroup": "Personbil",
                    "structureNo": "1230009211932022026",
                    "modelGeneration": "5B",
                    "modelSplitName": null,
                    "segment": "Mellomklassen",
                    "chassisShortName": "STV",
                    "chassis": "Stasjonsvogn",
                    "transmissionShortName": "AUT",
                    "transmission": "Automat",
                    "energySourceShortName": "BE",
                    "energySource": "Bensin Hybrid",
                    "totalEngines": 2,
                    "emissionStandard": "Euro 6",
                    "importPrice": 495100,
                    "currencyCode": "NOK",
                    "approved": "2022-01-07T16:56:42+01:00",
                    "transferred": "2022-12-12"
                }
            }
        }
    ],
    "requestAt": "2026-03-25T08:50:50+01:00"
}

Feltbeskrivelser for forespørsel

Rotnivåfelter

Felt	Type	Beskrivelse	Verdier
`id`	string	Den unike IDen for forespørselen.	22 characters, unikt generert. Eksempel: `"xtNczK2rUAh5lfz-i26iO"`
`requestAt`	string	Når forespørselen ble sendt.	ISO 8601 (fullstendig). Eksempel: `"2026-03-25T08:50:50+01:00"`

Person-objekt

Felt	Type	Beskrivelse	Verdier
`pid`	string	Fødselsnummeret til den som skal forsikres.	11-sifret tall som string. Eksempel: `"10816797409"`
`firstName`	string	Fornavnet til den som skal forsikres.	Eksempel: `"FORETAKSOM"`
`lastName`	string	Etternavnet til den som skal forsikres.	Eksempel: `"KONGE"`
`addresses`	array	Informasjon om adressen til den som skal forsikres.	Se Adresse-objekt
`memberships`	array	Informasjon om diverse medlemskap om personen som skal forsikres. Kan være tom liste.	Se Medlemskap-objekt

Adresse-objekt

Felt	Type	Beskrivelse	Verdier
`source`	string	Kilde for adressen	`"folkeregisteret"`
`streetName`	string	Gatenavn.	Eksempel: `"Munkerekkveien 110"`
`postalCode`	string	Postnummer.	4-sifret tall som string.
`postalLocation`	string	Poststed.	Store bokstaver. Eksempel: `"VESTSKOGEN"`

Medlemskap-objekt

Felt	Type	Beskrivelse	Verdier
`membershipId`	string	Organisasjonsnummeret til tilbyder av medlemskapet.	9 siffer som string. Eksempel: `"821395476"`
`membershipName`	string	Navnet til organisasjonen som tilbyr medlemskapet.	Eksempel: `"Norske Arkitekters Landsforbund"`

Tilbudsforespørsel-objekt

Felt	Type	Beskrivelse	Verdier
`id`	string	Den unike ID-en for forespørselen om tilbud på dette produktet.	22 characters, unikt generert. Eksempel: `"iKiLHD0opex6UcUqxyL3j"`
`type`	string	Type produkt.	`"bil"`
`data`	object	Data for tilbudet.	Se Tilbudsdata-objekt

Tilbudsdata-objekt

Felt	Type	Beskrivelse	Verdier
`coverage`	string	Dekning for forsikringen.	`"ansvar"` `"delkasko"` `"kasko"` `"utvidet"`
`addons`	array	Tilleggsdekninger for forsikringen. Kan inneholde flere verdier. Er et tomt array når ingen tilleggsdekninger er valgt.	I array: `"leiebil"` `"maskinskade"`
`bonus`	string	Bonus for forsikringen.	`"75% > 5 år"` `"75% > 4 år"` `"75% > 3 år"` `"75% > 2 år"` `"75%"` `"70% > 5 år"` `"70% > 4 år"` `"70% > 3 år"` `"70% > 2 år"` `"70%"` `"60%"` `"50%"` `"40%"` `"30%"` `"20%"` `"10%"` `"0%"` `"startbonus"` `"-10%"` `"-20%"` `"-30%"` `"-40%"`
`yearlyMileage`	integer	Årlig kjørelengde oppgitt i antall km.	Fra `5000` til `50000`, eller `0` ved ubegrenset kjørelengde.
`youngestDriver`	integer	Alder på yngste fører oppgitt i antall år.	Fra `18` til `25`. Når yngste fører er eldre enn 25, sender vi fremdeles `25` som verdi her.
`loan`	boolean	Om det er lån på bilen.	`true` `false`
`currentMileage`	integer	Nåværende kilometerstand.	Fra `0` til `999999`.
`currentAccidents`	integer	Antall ulykker de siste fem årene.	Fra `0` til `10`. Ved flere enn 10 ulykker, sender vi fremdeles `10` som verdi her.
`lastAccidentDate`	string, nullable	Dato for siste ulykke innenfor de siste fem årene.	`"yyyy-mm-dd"` Eksempel: `"2024-10-16"`
`deductible`	integer	Egenandel for forsikringen oppgitt i NOK.	Fra `4000` til `35000`.

Bileier-objekt

Felt	Type	Beskrivelse	Verdier
`ownerType`	string	Type eier.	`"sameAsPerson"` `"otherOwner"` `"leasing"`
`leasingCompanyOrg`	string, nullable	Organisasjonsnummer for leasingselskap.	Eksempel: `"123456789"`
`otherOwner`	object, nullable	Informasjon om annen eier.	Se Annen eier-objekt

Annen eier-objekt

Dette objektet er kun med i forespørselen når ownerType = "otherOwner".

Felt	Type	Beskrivelse	Verdier
`pid`	string	Fødselsnummer til annen eier.	Eksempel: `"09916795316"`
`firstName`	string	Fornavn til annen eier.	Eksempel: `"ALICE"`
`lastName`	string	Etternavn til annen eier.	Eksempel: `"WONDERLAND"`

Bil-objekt

Informasjon om bilen som skal forsikres. Alle feltene utenom source, regNumber og registrationDate kommer direkte fra OFV Kjøretøydata.

Data med kilde "ofv" er ikke tilgjengelig for kjøretøy hentet fra "tenor" i testmiljø.

Felt	Type	Beskrivelse	Verdier
`source`	string	Kilde for bildata.	`"ofv"` `"tenor"` (kun i testmiljø)
`regNumber`	string, valgfri/nullable	Registreringsnummer på bilen.	Eksempel: `"AB12345"`
`registrationDate`	date	Dato for første registrering.	`"yyyy-mm-dd"` Eksempel: `"2023-01-01"`
`structureNo`	string	Unikt strukturnummer for bilen.	Eksempel: `"4360005000112020000"`
`variantId`	integer	Variant-id for bilmodell.	Eksempel: `419436`
`vehicleGroup`	string	Kjøretøygruppe.	Eksempel: `"Personbil"`
`modelYear`	integer	Årsmodell for bilen.	Eksempel: `2025`
`brandName`	string	Merkenavn for bilen.	Eksempel: `"Tesla"`
`brandCode`	integer	Merkekode for bilen.	Eksempel: `4360`
`modelName`	string	Modellnavn for bilen.	Eksempel: `"Model Y"`
`modelCode`	integer	Modellkode for bilen.	Eksempel: `5`
`modelGeneration`	string	Modellgenerasjon for bilen.	Eksempel: `"1"`
`modelSplitName`	string, nullable	Ytterligere modellspesifikasjon.	Eksempel: `"Sportwagon"`
`variantName`	string	Variantnavn for bilmodell.	Eksempel: `"Long Range AWD"`
`variantCode`	integer	Variantkode for bilmodell.	Eksempel: `11`
`segment`	string	Segmentet bilen tilhører.	Eksempel: `"SUV mellomklasse"`
`chassisShortName`	string	Karosserikode for bilen.	Eksempel: `"SUV"`
`chassis`	string	Karosseribeskrivelse for bilen.	Eksempel: `"Sport Utility Vehicle"`
`transmissionShortName`	string	Kode for girkasse.	Eksempel: `"AUT"`
`transmission`	string	Type girkasse.	Eksempel: `"Automat"`
`energySourceShortName`	string	Kode for energikilde.	Eksempel: `"E"`
`energySource`	string	Type energikilde (elektrisitet, bensin, osv).	Eksempel: `"Elektrisitet"`
`totalEngines`	integer	Antall motorer.	Eksempel: `2`
`emissionStandard`	string	Utslippsklasse.	Eksempel: `"Euro 6"`
`importPrice`	integer	Importpris på bilen.	Eksempel: `471587`
`currencyCode`	string	Valutakode for importpris.	Eksempel: `"NOK"`
`approved`	string	Tidspunkt for godkjenning.	ISO 8601 (fullstendig). Eksempel: `"2024-10-16T12:06:00Z"`
`transferred`	string, nullable	Tidspunkt for overføring.	ISO 8601 (kun dato). Eksempel: `"2024-10-16"`

Forespørsel med flere tilbud

Dersom forespørselen inneholder flere tilbud, vil forespørselen se slik ut. Her har det blitt lagt til et ekstra tilbud (offerRequest) for hver unike bil:

{
    "id": "5Cw2lTTdy8HZA9Z1RBcKb",
    "person": {
        "pid": "10816797409",
        "firstName": "FORETAKSOM",
        "lastName": "KONGE",
        "addresses": [
            {
                "source": "folkeregisteret",
                "streetName": "Munkerekkveien 110",
                "postalCode": "3142",
                "postalLocation": "VESTSKOGEN"
            }
        ],
        "memberships": [
            {
                "membershipId": "821395476",
                "membershipName": "Norske Arkitekters Landsforbund"
            }
        ]
    },
    "offerRequest": [
        {
            "id": "lmp5_fChNgDt6zbtE1HuQ",
            "type": "bil",
            "data": {
                "coverage": "kasko",
                "addons": ["leiebil"],
                "bonus": "75%",
                "yearlyMileage": 12000,
                "youngestDriver": 25,
                "loan": false,
                "currentMileage": 50000,
                "currentAccidents": 1,
                "lastAccidentDate": "2023-02-05",
                "deductible": 6000,
                "carOwner": {
                    "ownerType": "otherOwner",
                    "leasingCompanyOrg": null,
                    "otherOwner": {
                        "pid": "09916795316",
                        "firstName": "FJÅNG",
                        "lastName": "REGEL"
                    }
                },
                "car": {
                    "source": "ofv",
                    "registrationDate": "2022-01-01",
                    "variantId": 385869,
                    "modelYear": 2022,
                    "brandName": "Audi",
                    "brandCode": 1230,
                    "modelName": "A4",
                    "modelCode": 9,
                    "variantName": "Avant Advanced 35 TFSi 150hk",
                    "variantCode": 21193,
                    "vehicleGroup": "Personbil",
                    "structureNo": "1230009211932022026",
                    "modelGeneration": "5B",
                    "modelSplitName": null,
                    "segment": "Mellomklassen",
                    "chassisShortName": "STV",
                    "chassis": "Stasjonsvogn",
                    "transmissionShortName": "AUT",
                    "transmission": "Automat",
                    "energySourceShortName": "BE",
                    "energySource": "Bensin Hybrid",
                    "totalEngines": 2,
                    "emissionStandard": "Euro 6",
                    "importPrice": 495100,
                    "currencyCode": "NOK",
                    "approved": "2022-01-07T16:56:42+01:00",
                    "transferred": "2022-12-12"
                }
            }
        },
        {
            "id": "BV_bS5xXoceIl26zftqd5",
            "type": "bil",
            "data": {
                "coverage": "utvidet",
                "addons": [
                    "leiebil",
                    "maskinskade"
                ],
                "bonus": "60%",
                "yearlyMileage": 30000,
                "youngestDriver": 25,
                "loan": true,
                "currentMileage": 35000,
                "currentAccidents": 1,
                "lastAccidentDate": "2023-02-05",
                "deductible": 8000,
                "carOwner": {
                    "ownerType": "sameAsPerson"
                },
                "car": {
                    "source": "ofv",
                    "registrationDate": "2013-01-01",
                    "variantId": 220765,
                    "modelYear": 2013,
                    "brandName": "Tesla",
                    "brandCode": 4360,
                    "modelName": "Model S",
                    "modelCode": 2,
                    "variantName": "60",
                    "variantCode": 1,
                    "vehicleGroup": "Personbil",
                    "structureNo": "4360002000012013002",
                    "modelGeneration": "1",
                    "modelSplitName": null,
                    "segment": "Luksusbiler",
                    "chassisShortName": "COM",
                    "chassis": "Kombikupé",
                    "transmissionShortName": "AUT",
                    "transmission": "Automat",
                    "energySourceShortName": "E",
                    "energySource": "Elektrisitet",
                    "totalEngines": 1,
                    "emissionStandard": "Euro 6",
                    "importPrice": 446500,
                    "currencyCode": "NOK",
                    "approved": "2013-10-16T14:35:25+02:00",
                    "transferred": "2014-02-14"
                }
            }
        }
    ],
    "requestAt": "2026-03-25T08:50:50+01:00"
}

Tenor testdata-forespørsel

I testmiljø kan det også forekomme forespørsler med kjøretøy fra Tenor sitt datasett. Disse inneholder ikke informasjon fra OFV sin database:

{
    "id": "BoZTghz7UJbJZ1mA28NnY",
    "person": {
        "pid": "10816797409",
        "firstName": "FORETAKSOM",
        "lastName": "KONGE",
        "addresses": [
            {
                "source": "folkeregisteret",
                "streetName": "Munkerekkveien 110",
                "postalCode": "3142",
                "postalLocation": "VESTSKOGEN"
            }
        ],
        "memberships": [
            {
                "membershipId": "821395476",
                "membershipName": "Norske Arkitekters Landsforbund"
            }
        ]
    },
    "offerRequest": [
        {
            "id": "x7-xjveF1WKuWXVXMyQ3G",
            "type": "bil",
            "data": {
                "coverage": "utvidet",
                "addons": [],
                "bonus": "50%",
                "yearlyMileage": 10000,
                "youngestDriver": 25,
                "loan": true,
                "currentMileage": 15000,
                "currentAccidents": 0,
                "lastAccidentDate": null,
                "deductible": 8000,
                "carOwner": {
                    "ownerType": "sameAsPerson",
                    "leasingCompanyOrg": null,
                    "otherOwner": null
                },
                "car": {
                    "source": "tenor",
                    "regNumber": "CO10028"
                }
            }
        }
    ],
    "requestAt": "2026-03-25T08:50:50+01:00"
}

Mulige verdier for medlemskap-felt (under arbeid)

membershipId	membershipName
`934469267`	`Arkitektenes Fagforbund`
`960472764`	`Befalets Fellesorganisasjon`
`948383268`	`BOB`
`936560288`	`Coop`
`970217215`	`Delta`
`970430911`	`Den Norske Jordmorforening`
`960474341`	`Den Norske Legeforening`
`870167962`	`Den Norske Tannlegeforening`
`979469241`	`Den Norske Turistforening`
`966251808`	`Den Norske Veterinærforening`
`980331105`	`Finansforbundet`
`926490842`	`Flyt-kunde`
`874250082`	`Huseierne`
`971526726`	`Krigsskoleutdannede Offiserers Landsforening`
`971480416`	`Kriminalomsorgens Yrkesforbund`
`964422206`	`LOfavør`
`970168451`	`Naturviterne`
`944383832`	`Norges Automobil-Forbund`
`939678670`	`Norges Bondelag`
`856331482`	`Norges Ingeniør- og Teknologorganisasjon`
`970204938`	`Norges Offisers- og Spesialistforbund`
`970167943`	`Norsk Bonde- og Småbrukarlag`
`971074345`	`Norsk Jernbaneforbund`
`879495512`	`Norsk Lektorlag`
`971056541`	`Norsk Lokomotivførerforbund`
`970168419`	`Norsk Psykologforening`
`960893506`	`Norsk Sykepleierforbund`
`971043059`	`Norsk Tjenestemannslag`
`974235307`	`Norsk Tollerforbund`
`844146302`	`Norske Arkitekters Landsforbund`
`937052766`	`OBOS`
`971480270`	`Parat`
`871278342`	`Regnskap Norge`
`980374068`	`Revisorforeningen`
`964812578`	`SAFE`
`971277270`	`Samfunnsviterne`
`970168621`	`Samfunnsøkonomene`
`970149406`	`Skolelederforbundet`
`971435712`	`STAFO`
`971420782`	`Teknisk-naturvitenskapelig Forening`
`884026172`	`Utdanningsforbundet`
`971436050`	`Yrkestrafikkforbundet`

Respons fra forsikringsselskap

Dette er en beskrivelse av hvordan responsen fra forsikringsselskapet skal være utformet. Det er lagt til eksempler på hva hvert felt skal inneholde.

Eksempel på respons

Responsen tar utgangspunkt i det første eksempelet for forespørsler.

{
    "id": "xtNczK2rUAh5lfz-i26iO",
    "company": "Forsikringselskap Ipsum AS",
    "totalPrice": 15883,
    "totalDiscount": 700,
    "totalOriginalPrice": 16583,
    "basePrice": 100,
    "products": [
        {
            "id": "iKiLHD0opex6UcUqxyL3j",
            "type": "bil",
            "productName": "Bilforsikring Kasko",
            "prices": {
                "price": 16133,
                "originalPrice": 16583,
                "tfa": 2483.7
            },
            "productDetails": {
                "coverage": "kasko",
                "addons": [
                    "leiebil"
                ],
                "ipidUrls": [
                    {
                        "url": "https://www.forsikringipsum.no/ipid_bilforsikring",
                        "updatedAt": "2026-01-01T12:00:00.00Z"
                    }
                ],
                "termsUrls": [
                    {
                        "url": "https://www.forsikringipsum.no/vilkar_bilforsikring_kasko",
                        "updatedAt": "2026-01-01T12:00:00.00Z"
                    },
                    {
                        "url": "https://www.forsikringipsum.no/vilkar_leiebil",
                        "updatedAt": "2026-01-01T12:00:00.00Z"
                    }
                ]
            },
            "offer": {
                "bonus": "75%",
                "deductible": 6000,
                "yearlyMileage": 12000
            }
        }
    ],
    "discounts": [
        {
            "amount": 450,
            "title": "Lorem ipsum",
            "description": "Lorem ipsum dolor sit amet consectetur adipiscing elit",
            "scope": "product",
            "id": "iKiLHD0opex6UcUqxyL3j"
        },
        {
            "id": "xtNczK2rUAh5lfz-i26iO",
            "amount": 350,
            "title": "Lorem ipsum",
            "description": "Lorem ipsum dolor sit amet consectetur adipiscing elit",
            "scope": "package"
        }
    ],
    "additionalFees": [
        {
            "id": "xtNczK2rUAh5lfz-i26iO",
            "amount": 150,
            "title": "Lorem ipsum",
            "description": "Lorem ipsum dolor sit amet consectetur adipiscing elit",
            "scope": "package"
        }
    ],
    "membershipApplied": "Norske Arkitekters Landsforbund",
    "uniqueSellingPoints": [
        "Lorem ipsum dolor sit amet",
        "Consectetur adipiscing elit"
    ],
    "purchaseUrl": "https://forsikringipsum.no/handlekurv",
    "receivedAt": "2026-03-27T12:07:42.36Z",
    "responseAt": "2026-03-27T12:07:49.53Z"
}

Feltbeskrivelser for respons

Rotnivåfelter

Felt	Type	Beskrivelse	Gyldige verdier
`id`	string	Samme ID som ble mottatt på rotnivå i forespørselen	Må være lik `id` fra rotnivå i forespørselen. Eksempel: `"xtNczK2rUAh5lfz-i26iO"`
`company`	string	Navnet på forsikringsselskapet.	Eksempel: `"Forsikringsselskap"`
`totalPrice`	integer	Total pris for alle produkter etter rabatt.	Må være større enn `0`. Eksempel: `4500`
`totalDiscount`	integer	Total rabatt for hele forsikringstilbudet.	Må være større enn eller lik `0`. Eksempel: `200`
`totalOriginalPrice`	integer	Total originalpris for hele forsikringstilbudet før rabatt.	Må være større enn eller lik `0`. Må være større enn eller lik `totalPrice`. Eksempel: `4700`
`basePrice`	integer	Grunnpris som er inkludert i beregning av totalprisen som er gitt.	Må være større enn eller lik `0`. Eksempel: `100`
`products`	array	Produktene som er med i forsikringstilbudet.	Må ha likt antall elementer som `offerRequest` i forespørselen.
`discounts`	array	Rabattene som er med i forsikringstilbudet.	Kan være tomt. Se Rabatter-array
`additionalFees`	array	Ekstra gebyrer som gjelder for forsikringstilbudet.	Kan være tomt. Se Gebyrer-array
`membershipApplied`	string, nullable	Medlemskapet som er tatt i bruk for beregning av pris.	Kan være `null`. Dersom den ikke er `null`, må den være lik et av medlemskapene som var med i forespørselen.
`uniqueSellingPoints`	array	USP-er fra selskapet.	Kan være tomt. Maks 5 string-elementer. Maks lengde per string er 250 characters.
`purchaseUrl`	string	URL for å kjøpe produktene.	HTTPS URL. Eksempel: `"https://forsikringipsum.no/handlekurv"`
`receivedAt`	string	Tidspunkt for når forespørselen ble mottatt.	ISO 8601 (fullstendig). Eksempel: `"2026-03-27T12:07:42.36Z"`
`responseAt`	string	Tidspunkt for når responsen ble sendt.	ISO 8601 (fullstendig). Eksempel: `"2026-03-27T12:07:49.53Z"`

Produkter-array

Felt	Type	Beskrivelse	Gyldige verdier
`id`	string	ID-en tilknyttet produkttilbudet.	Må være lik en ID fra `offerRequest` i forespørselen. Eksempel: `"iKiLHD0opex6UcUqxyL3j"`
`type`	string	Type forsikringsprodukt.	`"bil"`
`productName`	string	Navnet på produktet.	Eksempel: `"Bilforsikring"`
`prices`	objekt	Prisverdier for produktet.	Se Priser-objekt
`productDetails`	objekt	Produktdetaljer.	Se Produktdetaljer-objekt
`offer`	objekt	Tilbud for produktet.	Se Tilbud-objekt

Rabatter-array

Felt	Type	Beskrivelse	Gyldige verdier
`id`	string	ID-en til det som rabatten gjelder for.	Må være lik enten `id` fra rotnivå i forespørselen eller fra et av elementene i `offerRequest`.
`amount`	integer, nullable	Rabatt oppgitt i NOK. Valgfritt å oppgi.	Kan være `null`. Dersom den ikke er `null`, må den være større enn `0`.
`title`	string	Tittel på rabatten.	Maks lengde på 50 characters. Eksempel: `"Lojalitetsrabatt"`
`description`	string, nullable	Beskrivelse av rabatten.	Kan være `null`. Maks lengde på 250 characters.
`scope`	string	Angir om rabatten gjelder for et spesifikt produkt eller hele forsikringstilbudet.	`"product"` `"package"`

Gebyrer-array

Felt	Type	Beskrivelse	Gyldige verdier
`id`	string	ID-en til det som gebyret gjelder for.	Må være lik enten `id` fra rotnivå i forespørselen eller fra et av elementene i `offerRequest`.
`amount`	integer	Beløp på gebyret oppgitt i NOK.	Må være større enn `0`.
`title`	string	Tittel på gebyret.	Maks lengde på 50 characters. Eksempel: `"Etableringsgebyr"`.
`description`	string, nullable	Beskrivelse av gebyret.	Kan være `null`. Maks lengde på 250 characters.
`scope`	string	Angir om gebyret gjelder for et spesifikt produkt eller hele forsikringstilbudet.	`"product"` `"package"`

Priser-objekt

Felt	Type	Beskrivelse	Gyldige verdier
`price`	integer	Pris for produktet etter rabatt	Må være større enn `0`.
`originalPrice`	integer	Originalpris for produktet før rabatt	Må være større enn eller lik `0`. Må være større enn eller lik `price`.
`tfa`	decimal	TFA-avgift for produktet	Må være større enn eller lik `0.0`.

Produktdetaljer-objekt

Felt	Type	Beskrivelse	Gyldige verdier
`coverage`	string	Dekning for produktet	`"ansvar"` `"delkasko"` `"kasko"` `"utvidet"`
`addons`	array	Tilleggsdekninger som er med i produktet.	I array: `"leiebil"` `"maskinskade"`
`ipidUrls`	array	Liste med direkte nedlastningslenker til IPID-dokumenter (insurance product information document).	Se IPID-array
`termsUrls`	array	Liste med direkte nedlastningslenker til vilkår for produktet	Se Vilkår-array

IPID-array

Felt	Type	Beskrivelse	Gyldige verdier
`url`	string	Nedlastningslenke til IPID	HTTPS URL
`updatedAt`	string	Tidspunkt for siste oppdatering av IPID.	ISO 8601 (fullstendig). Eksempel: `"2026-01-01T12:00:00.00Z"`

Vilkår-array

Felt	Type	Beskrivelse	Gyldige verdier
`url`	string	Nedlastningslenke til vilkår	HTTPS URL
`updatedAt`	string	Tidspunkt for siste oppdatering av vilkår.	ISO 8601 (fullstendig). Eksempel: `"2026-01-01T12:00:00.00Z"`

Tilbud-objekt

Felt	Type	Beskrivelse	Gyldige verdier
`bonus`	string	Bonus for produktet	`"75% > 5 år"` `"75% > 4 år"` `"75% > 3 år"` `"75% > 2 år"` `"75%"` `"70% > 5 år"` `"70% > 4 år"` `"70% > 3 år"` `"70% > 2 år"` `"70%"` `"60%"` `"50%"` `"40%"` `"30%"` `"20%"` `"10%"` `"0%"` `"startbonus"` `"-10%"` `"-20%"` `"-30%"` `"-40%"`
`deductible`	integer	Egenandel for produktet opgitt i NOK.	Fra `4000` til `35000`.
`yearlyMileage`	integer	Årlig kjørelengde for bilprodukt oppgitt i antall km.	Fra `5000` til `50000`, eller `0` ved ubegrenset kjørelengde.

Beskrivelse av kjøpslenke

Selskapet kan velge mellom to løsninger for lenken i feltet purchaseUrl:

A. Videreføring av tilbudet

Lenken fører brukere til en personlig side hos Selskapet, for eksempel en handlekurv, «Min side» eller lignende, hvor brukere etter autentisering hos Selskapet kan motta bindende tilbud og/eller fullføre tegning av forsikring på bakgrunn av det opprinnelige tilbudet returnert til Finansportalen Forsikring. Lenken i seg selv inneholder ingen personopplysninger og brukere får tilgang til informasjonen knyttet til tilbudet først etter å ha identifisert seg hos Selskapet.

B. Videre til Selskapets nettside

Lenken fører brukere til Selskapets nettside, produktside eller lignende, hvor brukere selv går i dialog med Selskapet for å motta et bindende tilbud og/eller tegne forsikring. Lenken inneholder ingen personopplysninger og brukere får ikke tilgang til informasjonen knyttet til det opprinnelige tilbudet returnert til Finansportalen Forsikring.

Ved feil

Hvis feil, ønsker vi at selskapet svarer med en representativ HTTP-statuskode og følgende body:

{
    "error": {
        "code": "string",
        "message": "string"
    }
}

Ved eventuelle feil for ett produkt i en forespørsel om flere produkter, vil hele forespørselen feile.

Tekniske feil

Kode	Beskrivelse
`validation_error`	Ugyldige eller manglende felter i forespørselen
`failed_calculating_price`	Systemet klarte ikke å beregne pris pga. intern feil, for eksempel intern feil ved utføring av kalkulasjoner eller manglende data fra Forbrukerrådet
`service_unavailable`	Tjenesten er midlertidig utilgjengelig (f.eks. vedlikehold eller kapasitetsproblemer)
`unknown_error`	Uforutsett feil som ikke passer inn i de andre kategoriene

Andre feil

Kode	Beskrivelse
`no_price_available`	Selskapet kan ikke tilby pris, og ville heller ikke gitt pris i sin åpne webløsning, for eksempel fordi kombinasjon av parametere ikke støttes
`existing_agreement`	Selskapet returnerer ikke pris fordi brukeren allerede har en avtale på det gitte produktet hos selskapet
`additional_information_required`	Forespørselen krever mer informasjon; brukeren må kontakte rådgiver

Forespørsel fra Forbrukerrådet​

Eksempel på forespørsel​

Feltbeskrivelser for forespørsel​

Rotnivåfelter​

Person-objekt​

Adresse-objekt​

Medlemskap-objekt​

Tilbudsforespørsel-objekt​

Tilbudsdata-objekt​

Bileier-objekt​

Annen eier-objekt​

Bil-objekt​

Forespørsel med flere tilbud​

Tenor testdata-forespørsel​

Mulige verdier for medlemskap-felt (under arbeid)​

Respons fra forsikringsselskap​

Eksempel på respons​

Feltbeskrivelser for respons​

Rotnivåfelter​

Produkter-array​

Rabatter-array​

Gebyrer-array​

Priser-objekt​

Produktdetaljer-objekt​

IPID-array​

Vilkår-array​

Tilbud-objekt​

Beskrivelse av kjøpslenke​

A. Videreføring av tilbudet​

B. Videre til Selskapets nettside​

Ved feil​

Tekniske feil​

Andre feil​

Forespørsel fra Forbrukerrådet

Eksempel på forespørsel

Feltbeskrivelser for forespørsel

Rotnivåfelter

Person-objekt

Adresse-objekt

Medlemskap-objekt

Tilbudsforespørsel-objekt

Tilbudsdata-objekt

Bileier-objekt

Annen eier-objekt

Bil-objekt

Forespørsel med flere tilbud

Tenor testdata-forespørsel

Mulige verdier for medlemskap-felt (under arbeid)

Respons fra forsikringsselskap

Eksempel på respons

Feltbeskrivelser for respons

Rotnivåfelter

Produkter-array

Rabatter-array

Gebyrer-array

Priser-objekt

Produktdetaljer-objekt

IPID-array

Vilkår-array

Tilbud-objekt

Beskrivelse av kjøpslenke

A. Videreføring av tilbudet

B. Videre til Selskapets nettside

Ved feil

Tekniske feil

Andre feil