Introduction
Get offers and quote for partner finance car insurance
Process
Get Products Details
Products details available for the Developer.
Request
GET /products/insurance-car-financeHost: https://preprod-api.almbrand.dkContent-Type: application/json
Accept-Language: da-DKAuthorization: Bearer {{access_token}}ocp-apim-subscription-key: {{subcription_key}}
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"product_name": "insurance-car-finance",
"title": "Partner Forsikring Bil Finance",
"parameters": [
{
"default": "1",
"name": "payments_per_year",
"title": "Antal præmie betalinger på et år",
"type": "enum",
"options": [
{
"id": "1",
"title": 1
},
{
"id": "12",
"title": 12
}
],
"required": true
},
{
"name": "policy_holder",
"title": "Forsikringstager",
"type": "enum",
"options": [
{
"id": "person",
"title": "Person"
},
{
"id": "organization",
"title": "Virksomhed"
}
],
"required": true
},
{
"name": "vehicle_type",
"title": "Vehicle type",
"type": "enum",
"options": [
{
"id": "personbil",
"title": "Personbil"
},
{
"id": "varevogn",
"title": "Varevogn"
}
],
"required": true
},
{
"name": "youngest_user_age",
"title": "Alder på den yngste fører af køretøj",
"type": "number",
"required": false
},
{
"name": "vehicle_user",
"title": "Vehicle user",
"type": "enum",
"options": [
{
"id": "person",
"title": "Person"
},
{
"id": "organization",
"title": "Virksomhed"
}
],
"required": true
},
{
"name": "vehicle_price",
"title": "Ny pris eller aktuel pris for køretøj",
"type": "number",
"required": true
},
{
"name": "vehicle_owner",
"title": "Vehicle owner",
"type": "enum",
"options": [
{
"id": "person",
"title": "Person"
},
{
"id": "organization",
"title": "Virksomhed"
}
],
"required": true
},
{
"name": "youngst_user_birthdate",
"title": "Fødselsdato på den yngste fører af køretøj",
"type": "date",
"required": false
},
{
"name": "vehicle_usage",
"title": "Vehicle usage",
"type": "enum",
"options": [
{
"id": "privat_person_koersel",
"title": "Privat Personkørsel"
},
{
"id": "godstransport_halv_omsaetning",
"title": "Godstransport (½ oms.)"
},
{
"id": "godstransport",
"title": "Godstransport"
},
{
"id": "godstransport_erhverv",
"title": "Godstransport Erhverv"
},
{
"id": "godstransport_privat/erhverv",
"title": "Godstransport privat/erhverv"
}
],
"required": true
}
],
"features": [
{
"name": "standard",
"title": "Finansiering Standard",
"description": "Finansiering Standard",
"parameter_refs": [
"vehicle_price",
"policy_holder",
"youngest_user_age",
"youngest_user_birthdate",
"payments_per_year"
]
},
{
"name": "premium",
"title": "Finansiering Premium",
"description": "Finansiering Premium",
"parameter_refs": [
"vehicle_price",
"policy_holder",
"youngest_user_age",
"youngest_user_birthdate",
"payments_per_year"
]
}
]
}
Get Price Offer
Get a price offer on a car insurance. The price offer expires after af short period of time.
Product Variants
The partner finance product is available in two variants: Standard and Extended. This is derived from the combination of the parameters below:
policy_holder - the party paying the premiums
vehicle_owner - the party owning the vehicle (passenger car or van).
Special for the this product (partner finance product) the vehicle_owner is always the finance partner organization.vehicle_user - the party user the vehicle (passenger car or van). A primary user is a user who uses the vehicle regularly.
vehicle_usage - Indicates what is the vehicle used for.
Standard Variant
Is the variant used, when policy_holder and vehicle_user is a 'person' and vehicle_usage is 'privat_person_koersel'.
Extended Variant
Is the variant used, when policy_holder or vehicle_user is an organization or vehicle_usage is not 'privat_person_koersel.'
Request ( Standard Variant)
POST/insurance/car/offers
Host: https://preprod-api.almbrand.dk
Content-Type: application/json
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "person",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "1977-08-19"
},
"features": [
{
"name": "premium"
}
]
}
}
Alternatively, "youngest_user_age": "43" can be used instead of "youngest_user_birthdate":"1977-12-31"
Response (Standard Variant)
HTTP/1.1 200 OK
Content-Type: application/json
{
"price": {
"annually": 6480,
"monthly": 540
},
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "person",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "1977-08-19"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"coverages": [
{
"id": "M2IYMTRJYWITNWFHNI00MZGXLT",
"name": "udvidet_glas",
"deductible": 1614
},
{
"id": "MTNMMJYZYZQTNZFMNS00ZDDJLW",
"name": "ansvar",
"deductible": 4897
},
{
"id": "MJI4ZWYXODUTNZC4MC00YMY2LW",
"name": "lånebil"
},
{
"id": "NWM3NGVJODMTMZA0ZC00NJYYLT",
"name": "vejhjælp"
},
{
"id": "OWM2ZTK0N2ETZTHJNS00ZTA2LT",
"name": "påkørsel_af_dyr"
},
{
"id": "YJYWY2E1NMQTMGJINC00YWQ2LT",
"name": "udvidet_førerulykke"
},
{
"id": "OWNIZTG1MGUTMDC1OS00ZDE0LW",
"name": "kasko",
"deductible": 4897
}
]
}
],
"privacy": {
"policy_href": "https://www.almbrand.dk/kundeservice/generel-information/vi-passer-paa-dine-persondata/"
}
}
Request (Extended Variant)
POST/insurance/car/offers
Host: https://preprod-api.almbrand.dk
Content-Type: application/json
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000"
},
"features": [
{
"name": "premium"
}
]
}
}
Response ( Extended Variant)
HTTP/1.1 200 OK
Content-Type: application/json
{
"price": {
"annually": 7116,
"monthly": 593
},
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"coverages": [
{
"id": "NGYXYTJLN2UTMDIWMS00YTBILT",
"name": "statsafgift"
},
{
"id": "ZJQ5MTQ2YTQTMWFLZS00MJRJLT",
"name": "ansvar",
"deductible": 3585
},
{
"id": "YMI4N2ZMNWUTM2FLNC00OTA3LT",
"name": "førerulykke",
"limit": 656529
},
{
"id": "MDG3MWY1YTGTMZC5YS00YJY3LW",
"name": "kasko",
"deductible": 3585
},
{
"id": "OTMWOWI5ZDGTN2U5ZS00ZTBLLT",
"name": "redning_i_udlandet"
},
{
"id": "ZJU3NMY4YMETZJJIZC00ZJNJLT",
"name": "friskade"
},
{
"id": "ZTM2ZJQXMTCTMTK1YI00MWNKLT",
"name": "retshjælp",
"limit": 225000
}
]
}
],
"privacy": {
"policy_href": "https://www.almbrand.dk/kundeservice/generel-information/vi-passer-paa-dine-persondata/"
}
}
Create Price Quote
Creates a price quote on a partner finance product to named customers. The price quote expires after 30 days.
Product Variants
As described in "Get Price Offer ", the partner finance product is available in two variants: Standard and Extended and derived from the combination of the parameters (see "Get Price Offer")
Named Customers
The named customers are listed as parties at creation of the price quote.
The roles that a party plays in relation to a policy is specified via the following attributes:
policy_holder is true, if the party is a policy holder.
vehicle_owner is true, if the party is a vehicle owner. (will always be partner for finance products)
vehicle_user is true, if the party is a vehicle user.
Be aware that there is a dependency between the product variant parameters and the named customers, which gives validation errors if they do not match
Request (standard variant)
POST /insurance/car/quotes
Host: https://preprod-api.almbrand.dk
Content-Type: application/json
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_age": "34"
},
"features": [
{
"name": "premium"
}
]
},
"policy" : {
"external_reference" : "20200976201",
"brand_id" : "VWSFDK_VW",
"expected_effective_at" : "2020-12-31",
"insurable_object" : {
"vehicle" : {
"make" : "VW",
"model" : "Transporter",
"variant" : "6.1",
"vin" : "1MMBB41JXYN109186",
"registration_number" : "AK47540"
}
},
"parties" :[
{
"vehicle_user" : true,
"policy_holder" : true,
"person" : {
"cpr_number":"0101701234",
"first_name" : "Rene",
"last_name" : "Hansen"
},
"phone": "96101717",
"email": "jb@az.com",
"address" : {
"protected": false,
"street" : "Midtermolen",
"house_number" : "7A",
"floor": "2",
"door" : "2.1",
"postal_code": 2100,
"city" : "København Ø"
}
}
]
},
"agent" : {
"user_id" : "jsl@vw.dk",
"organization" : {
"name": "SEMLER RETAIL HOLBÆK A/S",
"cvr_number" : "21742031",
"cvrp_number" : "1005168532"
}
}
}
Response (standard variant)
HTTP/1.1 200 OK
Content-Type: application/json
{
"quote_id": "71b71e48-648d-4e52-961b-5dc34fd79536",
"price": {
"amount": 6480,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_age": "34"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"insurable_object": {
"vehicle": {
"make": "VW",
"model": "Transporter",
"variant": "6.1",
"vin": "1MMBB41JXYN109186",
"registration_number": "AK47540",
"vehicle_type": "01",
"vehicle_usage": "01"
}
},
"parties": [
{
"person": {
"cpr_number": "0101701234",
"first_name": "Rene",
"last_name": "Hansen"
},
"email": "jb@az.com",
"phone": "96101717",
"address": {
"protected": false,
"street": "Midtermolen",
"house_number": "7A",
"floor": "2",
"door": "2.1",
"postal_code": 2100,
"city": "København Ø"
},
"vehicle_user": true,
"policy_holder": true
}
],
"policy_number": "165613686",
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"insurer": {
"organization": {
"cvr_number": "10526949",
"name": "Alm. Brand Forsikring A/S"
},
"address": {
"street": "Midtermolen",
"house_number": "7",
"postal_code": 2100,
"city": "København Ø"
}
},
"coverages": [
{
"id": "MTNMMJYZYZQTNZFMNS00ZDDJLW",
"name": "ansvar",
"deductible": 2987
},
{
"id": "OWNIZTG1MGUTMDC1OS00ZDE0LW",
"name": "kasko",
"deductible": 2987
},
{
"id": "NWM3NGVJODMTMZA0ZC00NJYYLT",
"name": "vejhjælp"
},
{
"id": "M2IYMTRJYWITNWFHNI00MZGXLT",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "YJYWY2E1NMQTMGJINC00YWQ2LT",
"name": "udvidet_førerulykke"
},
{
"id": "OWM2ZTK0N2ETZTHJNS00ZTA2LT",
"name": "påkørsel_af_dyr"
},
{
"id": "MJI4ZWYXODUTNZC4MC00YMY2LW",
"name": "lånebil"
}
]
}
],
"agent": {
"user_id": "jsl@vw.dk",
"organization": {
"cvr_number": "21742031",
"cvrp_number": "1005168532",
"name": "SEMLER RETAIL HOLBÆK A/S"
}
},
"privacy": {
"policy_href": "https://www.almbrand.dk/kundeservice/generel-information/vi-passer-paa-dine-persondata/"
}
}
Request (Extended variant)
POST /insurance/car/quotes
Host: https://preprod-api.almbrand.dk
Content-Type: application/json
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000"
},
"features": [
{
"name": "premium"
}
]
},
"policy" : {
"external_reference" : "20200976201",
"brand_id" : "VWSFDK_VW",
"expected_effective_at" : "2020-12-31",
"insurable_object" : {
"vehicle" : {
"make" : "VW",
"model" : "Transporter",
"variant" : "6.1",
"vin" : "1MMBB41JXYN109186",
"registration_number" : "AK47540"
}
},
"parties" :[
{
"vehicle_owner" : true,
"policy_holder" : true,
"organization" : {
"name": "Alm. Brand",
"cvr_number":"81753512"
},
"person": {
"last_name": "Brammer",
"first_name": "Ove"
},
"phone": "96101717",
"email": "jb@az.com",
"address" : {
"protected": false,
"street" : "Midtermolen",
"house_number" : "7A",
"floor": "2",
"door" : "2.1",
"postal_code": 2100,
"city" : "København Ø"
}
}
]
},
"agent" : {
"user_id" : "jsl@vw.dk",
"organization" : {
"name": "SEMLER RETAIL HOLBÆK A/S",
"cvr_number" : "21742031",
"cvrp_number" : "1005168532"
}
}
}
Response (Extended variant)
HTTP/1.1 200 OK
Content-Type: application/json
{
"quote_id": "807d4bfd-c754-4a42-9238-830c4ca03b75",
"price": {
"amount": 3215,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "business-car-insurance-finance",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"policy_number": "165613708",
"insurable_object": {
"vehicle": {
"make": "VW",
"model" : "Transporter",
"variant": "6.1",
"vin": "1MMBB41JXYN109186",
"registration_number": "AK47540",
"vehicle_type": "03",
"vehicle_usage": "40"
}
},
"parties": [
{
"vehicle_user": true,
"policy_holder": true,
"organization": {
"cvr_number": "81753512"
},
"person": {
"first_name": "Ove"
"last_name": "Brammer",
},
"address": {
"street": "Midtermolen",
"house_number": "7",
"postal_code": 2100,
"city": "København Ø"
}
}
],
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"insurer": {
"organization": {
"cvr_number": "10526949",
"name": "Alm. Brand Forsikring A/S"
},
"address": {
"street": "Midtermolen",
"house_number": "7",
"postal_code": 2100,
"city": "København Ø"
}
},
"coverages": [
{
"id": "ZJQ5MTQ2YTQTMWFLZS00MJRJLT",
"name": "ansvar",
"deductible": 3585
},
{
"id": "NGYXYTJLN2UTMDIWMS00YTBILT",
"name": "statsafgift"
},
{
"id": "YMI4N2ZMNWUTM2FLNC00OTA3LT",
"name": "førerulykke"
},
{
"id": "MDG3MWY1YTGTMZC5YS00YJY3LW",
"name": "kasko",
"deductible": 3585
},
{
"id": "OTMWOWI5ZDGTN2U5ZS00ZTBLLT",
"name": "redning_i_udlandet"
},
{
"id": "ZTM2ZJQXMTCTMTK1YI00MWNKLT",
"name": "retshjælp",
"deductible": 2500
},
{
"id": "ZJU3NMY4YMETZJJIZC00ZJNJLT",
"name": "friskade"
}
]
}
],
"agent": {
"user_id": "jsl@vw.dk",
"organization": {
"cvr_number": "21742031",
"cvrp_number": "1005168532",
"name": "SEMLER RETAIL HOLBÆK A/S"
}
},
"privacy": {
"policy_href": "https://www.almbrand.dk/kundeservice/generel-information/vi-passer-paa-dine-persondata/"
}
}
Retrieve Quote (await_activation)
Get previously created quote that await activation.
If the price quote has expired (after 30 days) a 404 not found status code is returned.
GET /insurance/car/quotes/71b71e48-648d-4e52-961b-5dc34fd79536
Host: https://preprod-api.almbrand.dk
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
HTTP/1.1 200 OK
Content-Type: application/json
{
"quote_id": "71b71e48-648d-4e52-961b-5dc34fd79536",
"price": {
"amount": 6480,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "insurance-car-finance",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_age": "34"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"insurable_object": {
"vehicle": {
"make": "VW",
"model": "Transporter",
"variant": "6.1",
"vin": "1MMBB41JXYN109186",
"registration_number": "AK47540",
"vehicle_type": "01",
"vehicle_usage": "01"
}
},
"parties": [
{
"person": {
"cpr_number": "0101701234",
"first_name": "Rene",
"last_name": "Hansen"
},
"email": "jb@az.com",
"phone": "96101717",
"address": {
"protected": false,
"street": "Midtermolen",
"house_number": "7A",
"floor": "2",
"door": "2.1",
"postal_code": 2100,
"city": "København Ø"
},
"vehicle_user": true,
"policy_holder": true
}
],
"policy_number": "165613686",
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"insurer": {
"organization": {
"cvr_number": "10526949",
"name": "Alm. Brand Forsikring A/S"
},
"address": {
"street": "Midtermolen",
"house_number": "7",
"postal_code": 2100,
"city": "København Ø"
}
},
"coverages": [
{
"id": "MTNMMJYZYZQTNZFMNS00ZDDJLW",
"name": "ansvar",
"deductible": 2987
},
{
"id": "OWNIZTG1MGUTMDC1OS00ZDE0LW",
"name": "kasko",
"deductible": 2987
},
{
"id": "NWM3NGVJODMTMZA0ZC00NJYYLT",
"name": "vejhjælp"
},
{
"id": "M2IYMTRJYWITNWFHNI00MZGXLT",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "YJYWY2E1NMQTMGJINC00YWQ2LT",
"name": "udvidet_førerulykke"
},
{
"id": "OWM2ZTK0N2ETZTHJNS00ZTA2LT",
"name": "påkørsel_af_dyr"
},
{
"id": "MJI4ZWYXODUTNZC4MC00YMY2LW",
"name": "lånebil"
}
]
}
],
"agent": {
"user_id": "jsl@vw.dk",
"organization": {
"cvr_number": "21742031",
"cvrp_number": "1005168532",
"name": "SEMLER RETAIL HOLBÆK A/S"
}
},
"privacy": {
"policy_href": "https://www.almbrand.dk/kundeservice/generel-information/vi-passer-paa-dine-persondata/"
}
}
Activate Quote
Activate previously created quote.
If the price quote has expired (after 30 days) a 404 not found status code is returned.
PUT /insurance/car/quotes/01EH96X7TVRYV6PMXS7YAK9CJG/activation
Host: https://preprod-api.almbrand.dk
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
Response
HTTP/1.1 200 OK
Content-Type: application/json
{}
Retrieve Quote (activated)
Get previously created quote that is activated.
If the price quote has expired (after 30 days) a 404 not found status code is returned.
GET/insurance/car/quotes/01EH96X7TVRYV6PMXS7YAK9CJG
Host: https://preprod-api.almbrand.dk
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"quote_id" : "01EH96X7TVRYV6PMXS7YAK9CJG",
"price" : { ...},
"product" : { ...},
"polices" : [...] ,
"agent" : { ...},
"created_at": "2020-08-26T07:59:41.364Z"
}