Versjon: 1.0.2

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.

Hvis selskapet ikke har mulighet til å tilby en verdi til gunst for Forbrukeren, for eksempel fordi verdien som forespørres er i enden av skalaen, er det greit å levere nærmeste tilgjengelige verdi.

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 ID-en for forespørselen, generert av Forbrukerrådet.	22 tegn, unikt generert. Eksempel: `"xtNczK2rUAh5lfz-i26iO"`
`requestAt`	string	Tidspunkt for 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 av adresse-objekter	Informasjon om adressen til den som skal forsikres.	Inneholder aldri mer enn 1 element ved bilforsikring. Se Adresse-objekt
`memberships`	array av medlemskap-objekter	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 tegn, 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 av strings	Tilleggsdekninger for forsikringen. Kan inneholde flere verdier. Er et tomt array når ingen tilleggsdekninger er valgt.	Mulige elementer 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	Ønsket å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	Ønsket egenandel for forsikringen oppgitt i NOK. Gjelder kun ved kasko eller utvidet dekning.	`0` dersom `coverage` er `"ansvar"` eller `"delkasko"`. Ved høyere dekningsgrad er verdien 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, 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.

Alle datafelter i responsen, også de som er nullable, er obligatoriske.

Dersom en respons ikke oppfyller kravene blir den kastet, og tilbudet vil ikke vises i forsikringstjenesten.

Selskapene er forventet å svare innen rimelig tid på Forbrukerrådets prisforespørseler. Vi anser normal svartid til å være på under 15 sekunder. Selskaper som svarer raskt vil kunne bli vist tidligere i portalen.

Eksempel på respons

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

{
    "id": "xtNczK2rUAh5lfz-i26iO",
    "company": "Forsikringsselskap Ipsum AS",
    "totalPrice": 15883,
    "totalDiscount": 700,
    "totalOriginalPrice": 16583,
    "products": [
        {
            "id": "iKiLHD0opex6UcUqxyL3j",
            "type": "bil",
            "productName": "Bilforsikring Kasko",
            "prices": {
                "price": 16183,
                "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": [
        {
            "id": "iKiLHD0opex6UcUqxyL3j",
            "amount": 400,
            "title": "Lorem ipsum",
            "description": "Lorem ipsum dolor sit amet consectetur adipiscing elit",
            "scope": "product",
        },
        {
            "id": "xtNczK2rUAh5lfz-i26iO",
            "amount": 300,
            "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 Ipsum AS"`
`totalPrice`	integer	Total pris per år for alle produkter, etter rabatt. Alle gebyrer og avgifter (både på produktnivå og rotnivå) unntatt TFA skal være inkludert i denne prisen.	Må være større enn `0`. Må være lik `totalOriginalPrice` - `totalDiscount`.
`totalDiscount`	integer	Total rabatt for hele forsikringstilbudet. Absolutt alle rabatter, både de som gjelder individuelt for produktene og de som gjelder på pakkenivå skal være med i dette beløpet. Merk at selv om en rabatt kan ha `amount` = `null` i `discounts`, så skal det faktiske beløpet på rabatten fortsatt inngå dette feltet.	Kan ikke være mindre enn summen av alle `amount`-feltene i `discounts`-arrayet, men kan være større siden `amount` for rabatter er nullable.
`totalOriginalPrice`	integer	Total originalpris per år for hele forsikringstilbudet, før rabatt. Alle gebyrer og avgifter (både på produktnivå og rotnivå) unntatt TFA skal være inkludert i denne prisen.	Må være større enn `0`. Må være større enn eller lik `totalPrice`.
`products`	array av produkt-objekter	Produktene som er med i forsikringstilbudet.	Må ha likt antall elementer som `offerRequest` i forespørselen. Se Produkter-array
`discounts`	array av rabatt-objekter	Rabattene som er med i forsikringstilbudet.	Kan være tomt. Se Rabatter-array
`additionalFees`	array av gebyr-objekter	Ekstra avgifter og gebyrer som gjelder for forsikringstilbudet.	Kan være tomt. Se Gebyrer-array
`membershipApplied`	string, nullable	Navnet på medlemskapet som er tatt i bruk for beregning av pris.	Kan være `null`. Dersom den ikke er `null`, må den være nøyaktig lik ett av medlemskapsnavnene som var med i forespørselen.
`uniqueSellingPoints`	array av strings	USP-er fra selskapet.	Kan være tomt. Maks 5 string-elementer. Maks lengde per string er 250 tegn.
`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 Kasko"`
`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 tegn. Eksempel: `"Lojalitetsrabatt"`
`description`	string, nullable	Beskrivelse av rabatten.	Kan være `null`. Maks lengde på 250 tegn.
`scope`	string	Angir om rabatten gjelder for et spesifikt produkt eller hele forsikringstilbudet.	`"product"` `"package"`

Gebyrer-array

Alle kostnader/gebyrer som vil bli lagt til på fakturaen for perioden for tilbudet (ett år) skal rapporteres inn, enten det er grunnpris eller andre kostnader og/eller gebyrer ved opprettelse eller vedlikehold av kundeforhold eller ved hver enkelt forsikringsavtale.

Kostnader knyttet til valgmuligheter for fakturering som avtales i forbindelse med avtaleinngåelse skal ikke rapporteres inn.

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 tegn. Eksempel: `"Etableringsgebyr"`.
`description`	string, nullable	Beskrivelse av gebyret.	Kan være `null`. Maks lengde på 250 tegn.
`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 per år, etter rabatt. Uten gebyrer og kostnader eller TFA.	Må være større enn `0`.
`originalPrice`	integer	Originalpris/premie for produktet per år, før rabatt. Uten gebyrer og kostnader eller TFA.	Må være større enn `0`. Må være større enn eller lik `price`.
`tfa`	decimal	Trafikkforsikringsavgift for produktet. Dette er en ren tilleggsopplysning som ikke skal være en del av hverken `originalPrice` eller `totalOriginalPrice`.	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 av strings	Tilleggsdekninger som er med i produktet.	Kan være tomt. Gyldige elementer i array: `"leiebil"` `"maskinskade"`
`ipidUrls`	array av IPID-objekter	Liste med direkte nedlastningslenker til IPID-dokumenter (insurance product information document).	Må inneholde minst ett element. Se IPID-array
`termsUrls`	array av vilkår-objekter	Liste med direkte nedlastningslenker til vilkår for produktet	Må inneholde minst ett element. 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%"` `"-10%"` `"-20%"` `"-30%"` `"-40%"`
`deductible`	integer	Egenandel for produktet opgitt i NOK.	Fra `0` til `35000`.
`yearlyMileage`	integer	Årlig kjørelengde for bilprodukt oppgitt i antall km.	Fra `1` til `999999`, 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