Introduction
Get offers and quote for partner leasing car insurance
Process
Get Products Details
A list of all products available for the Developer.
Request
GET /products/insurance-car-leasingHost: 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-leasing",
"title" : "Partner Forsikring Bil Leasing",
"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" : "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
},
{
"name" : "youngest_user_birthdate",
"title" : "Fødselsdato på den yngste fører af køretøj",
"type" : "date",
"required" : false
}
],
"features" : [
{
"name" : "standard",
"title" : "Leasing Standard",
"description" : "Leasing Standard",
"parameter_refs" : [
"vehicle_user",
"vehicle_usage",
"policy_holder",
"vehicle_type",
"vehicle_owner",
"youngest_user_age",
"youngest_user_birthdate",
"payments_per_year",
"vehicle_price"
]
},
{
"name" : "premium",
"title" : "Leasing Premium",
"description" : "Leasing Premium",
"parameter_refs" : [
"vehicle_user",
"vehicle_usage",
"policy_holder",
"vehicle_type",
"vehicle_owner",
"youngest_user_age",
"youngest_user_birthdate",
"payments_per_year",
"vehicle_price"
]
}
]
}
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 leasing 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 leasing product) the vehicle_owner is always the leasing 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-leasing",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "2000-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": 9672,
"monthly": 806
},
"product": {
"product_name": "insurance-car-leasing",
"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_birthdate": "2000-08-19"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"coverages": [
{
"id": "NDG5OTC4MZATNDYWNS00MGU2LW",
"name": "kasko",
"deductible": 9793
},
{
"id": "MGNMOTQYNZYTYTQ1OC00YJY0LT",
"name": "ansvar",
"deductible": 9793
},
{
"id": "NJHKNTK5NZMTMZGWYS00ZJDMLW",
"name": "påkørsel_af_dyr"
},
{
"id": "OTZHMWM3N2QTMJI0OS00M2M4LW",
"name": "lånebil"
},
{
"id": "OWE5MGY3ZWETM2E4MY00NWQ3LW",
"name": "udvidet_glas",
"deductible": 1614
},
{
"id": "YJFJZMU3NTCTZDG3MC00MJVMLT",
"name": "udvidet_førerulykke"
},
{
"id": "YJI3MWQXMZGTZDE0NI00ZWFILT",
"name": "afleveringsforsikring",
"deductible": 5000,
"limit": 25000
},
{
"id": "ZTK4YZA5ODCTMTU2NI00YJEYLW",
"name": "vejhjælp"
}
]
}
],
"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.dkContent-Type: application/jsonAuthorization:
Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product":{
"product_name": "insurance-car-leasing",
"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 OKContent-Type: application/json
{
"price": {
"annually": 7116,
"monthly": 593
},
"product": {
"product_name": "insurance-car-leasing",
"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": "OTBJNDYXNTCTZTHHMS00Y2Q1LT",
"name": "førerulykke",
"limit": 656529
},
{
"id": "MTZINGQ3NGITOTKYMY00OTK4LW",
"name": "retshjælp",
"limit": 225000
},
{
"id": "MZFLY2I5ODGTZWEYMC00MTAWLW",
"name": "redning_i_udlandet"
},
{
"id": "YMM4YZYYOWQTMMFMZI00ZJJKLT",
"name": "kasko",
"deductible": 7500
},
{
"id": "YWJLYJG1YJQTZWNIZS00ZJVJLT",
"name": "friskade"
},
{
"id": "MMIZZJY4NDQTYTUYNI00ZMEXLT",
"name": "statsafgift"
},
{
"id": "MMVKMDG5NMYTNWRKMS00NGYXLW",
"name": "ansvar",
"deductible": 7500
}
]
}
],
"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 leasing product to named customers. The price quote expires after 30 days.
Product Variants
As described in "Get Price Offer ", the partner leasing 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 leasing 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-leasing",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "1977-08-19"
},
"features": [
{
"name": "premium"
}
]
},
"policy" : {
"brand_id" : "VWSFDK_VW",
"external_reference" : "20200976201",
"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": "433d9143-d0f7-4224-a006-419a2eac65b0",
"price": {
"amount": 7056,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "insurance-car-leasing",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "1977-08-19"
},
"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": "165613066",
"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": "MGNMOTQYNZYTYTQ1OC00YJY0LT",
"name": "ansvar",
"deductible": 2987
},
{
"id": "NDG5OTC4MZATNDYWNS00MGU2LW",
"name": "kasko",
"deductible": 2987
},
{
"id": "ZTK4YZA5ODCTMTU2NI00YJEYLW",
"name": "vejhjælp"
},
{
"id": "OWE5MGY3ZWETM2E4MY00NWQ3LW",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "YJI3MWQXMZGTZDE0NI00ZWFILT",
"name": "afleveringsforsikring",
"deductible": 5000
},
{
"id": "YJFJZMU3NTCTZDG3MC00MJVMLT",
"name": "udvidet_førerulykke"
},
{
"id": "NJHKNTK5NZMTMZGWYS00ZJDMLW",
"name": "påkørsel_af_dyr"
},
{
"id": "OTZHMWM3N2QTMJI0OS00M2M4LW",
"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-leasing",
"parameters": {
"payments_per_year": "1",
"vehicle_type": "varevogn",
"policy_holder": "organization",
"vehicle_user": "organization",
"vehicle_price": "359000",
"vehicle_owner": "organization",
"vehicle_usage": "godstransport"
},
"features": [
{
"name": "premium"
}
]
},
"policy": {
"brand_id": "VWSFDK_VW",
"expected_effective_at": "2020-12-31",
"external_reference": "20200976201",
"parties": [
{
"policy_holder": true,
"vehicle_user": true,
"organization": {
"name": "Alm. Brand",
"cvr_number": "81753512"
},
"person": {
"last_name": "Brammer",
"first_name": "Ove"
},
"phone": "96101717",
"email": "jb@az.com"
"address": {
"door": "2.1",
"protected": false,
"city": "København Ø",
"street": "Midtermolen",
"house_number": "7A",
"floor": "2",
"postal_code": 2100
},
}
],
"insurable_object": {
"vehicle": {
"registration_number": "AK47540",
"variant": "6.1",
"model": "Transporter",
"vin": "1MMBB41JXYN109186",
"make": "VW"
}
}
},
"agent": {
"user_id": "jsl@vw.dk",
"organization": {
"cvrp_number": "1005168532",
"name": "SEMLER RETAIL HOLBÆK A/S",
"cvr_number": "21742031"
}
}
}
Response (Extended variant)
HTTP/1.1 200 OK
Content-Type: application/json
{
"quote_id": "9af8d9d6-1099-440d-be82-4bf3b0426f23",
"price": {
"amount": 7200,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "business-insurance-car-leasing",
"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": "165613716",
"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": {
"last_name": "Brammer",
"first_name": "Ove"
},
"address": {
"street": "Midtermolen",
"house_number": "7",
"postal_code": 2100,
"city": "København Ø"
}
}
],
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"coverages": [
{
"id": "MMVKMDG5NMYTNWRKMS00NGYXLW",
"name": "ansvar",
"deductible": 3585
},
{
"id": "MMIZZJY4NDQTYTUYNI00ZMEXLT",
"name": "statsafgift"
},
{
"id": "OTBJNDYXNTCTZTHHMS00Y2Q1LT",
"name": "førerulykke"
},
{
"id": "YMM4YZYYOWQTMMFMZI00ZJJKLT",
"name": "kasko",
"deductible": 3585
},
{
"id": "MZFLY2I5ODGTZWEYMC00MTAWLW",
"name": "redning_i_udlandet"
},
{
"id": "MTZINGQ3NGITOTKYMY00OTK4LW",
"name": "retshjælp",
"deductible": 2500
},
{
"id": "YWJLYJG1YJQTZWNIZS00ZJVJLT",
"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.
If the price quote has expired (after 30 days) a 404 not found status code is returned.
GET /insurance/car/quotes/433d9143-d0f7-4224-a006-419a2eac65b0
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": "433d9143-d0f7-4224-a006-419a2eac65b0",
"price": {
"amount": 7056,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "insurance-car-leasing",
"parameters": {
"vehicle_type": "personbil",
"vehicle_usage": "privat_person_koersel",
"vehicle_user": "person",
"vehicle_owner": "organization",
"policy_holder": "person",
"payments_per_year": "1",
"vehicle_price": "359000",
"youngest_user_birthdate": "1977-08-19"
},
"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": "165613066",
"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": "MGNMOTQYNZYTYTQ1OC00YJY0LT",
"name": "ansvar",
"deductible": 2987
},
{
"id": "NDG5OTC4MZATNDYWNS00MGU2LW",
"name": "kasko",
"deductible": 2987
},
{
"id": "ZTK4YZA5ODCTMTU2NI00YJEYLW",
"name": "vejhjælp"
},
{
"id": "OWE5MGY3ZWETM2E4MY00NWQ3LW",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "YJI3MWQXMZGTZDE0NI00ZWFILT",
"name": "afleveringsforsikring",
"deductible": 5000
},
{
"id": "YJFJZMU3NTCTZDG3MC00MJVMLT",
"name": "udvidet_førerulykke"
},
{
"id": "NJHKNTK5NZMTMZGWYS00ZJDMLW",
"name": "påkørsel_af_dyr"
},
{
"id": "OTZHMWM3N2QTMJI0OS00M2M4LW",
"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.
POST /insurance/car/quotes/433d9143-d0f7-4224-a006-419a2eac65b0/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"
}