Introduction
Get offers and quote for partner standalonecar insurance
Process
Get Products Details
A list of all products available for the Developer.
Request
GET /products/insurance-car-standaloneHost: 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-standalone",
"title": "Partner Forsikring Bil Standalone",
"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": "vehicle_user",
"title": "Vehicle user",
"type": "enum",
"options": [
{
"id": "person",
"title": "Person"
},
{
"id": "organization",
"title": "Virksomhed"
}
],
"required": true
},
{
"name": "youngest_user_age",
"title": "Alder på den yngste fører af køretøj",
"type": "number",
"required": false
},
{
"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": "Enkeltstående Standard",
"description": "Enkeltstående Standard",
"parameter_refs": [
"vehicle_user",
"vehicle_usage",
"policy_holder",
"vehicle_type",
"vehicle_owner",
"payments_per_year",
"vehicle_price"
]
},
{
"name": "premium",
"title": "Enkeltstående Premium",
"description": "Enkeltstående Premium",
"parameter_refs": [
"vehicle_user",
"vehicle_usage",
"policy_holder",
"vehicle_type",
"vehicle_owner",
"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 standalone 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 standalone product) the vehicle_owner is always the standalone 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-standalone",
"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-standalone",
"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": "MDEYYTI4YMQTYTKZOC00MTVLLT",
"name": "udvidet_glas",
"deductible": 1614
},
{
"id": "OGY0NWFHNWMTZJUYYY00OTQXLW",
"name": "ansvar",
"deductible": 4897
},
{
"id": "MJLLZTU3MGUTM2JHMC00NWFJLT",
"name": "påkørsel_af_dyr"
},
{
"id": "MMFJNTU1YTUTNMJKMI00MDA5LW",
"name": "udvidet_førerulykke"
},
{
"id": "ODAWNWM2YJQTZJUYMS00NWM4LW",
"name": "lånebil"
},
{
"id": "NDI4YTI2MWETY2IWNC00MMEXLT",
"name": "kasko",
"deductible": 4897
},
{
"id": "ZJI5NDLLY2ITMWJINY00MTM5LT",
"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.dk
Content-Type: application/json
Authorization: Bearer {{access_token}}
ocp-apim-subscription-key: {{subcription_key}}
{
"product": {
"product_name": "insurance-car-standalone",
"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": 4208,
"monthly": 351
},
"product": {
"product_name": "insurance-car-standalone",
"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": "MDHLY2U2ZGMTZGQ5NI00NWNLLT",
"name": "kasko",
"deductible": 3585
},
{
"id": "NDMWY2U5MJITMGU5MY00MDJKLT",
"name": "friskade"
},
{
"id": "NTBLODVHOTKTZWZJYS00NWY5LW",
"name": "retshjælp",
"limit": 225000
},
{
"id": "ZDY4YZMWNJMTZJFJNI00ZMM4LW",
"name": "redning_i_udlandet"
},
{
"id": "NJDMMTU3MTETYJUWNC00NZNKLT",
"name": "førerulykke",
"limit": 656529
},
{
"id": "MJAYOGQ2MDMTMJM0OS00YTM4LW",
"name": "statsafgift"
},
{
"id": "MTJJYMQXZJITNZZLYI00MZE0LW",
"name": "ansvar",
"deductible": 3585
}
]
}
],
"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 standalone product to named customers. The price quote expires after 30 days.
Product Variants
As described in "Get Price Offer ", the partner standalone 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 standalone 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-standalone",
"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" : {
"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": "f3efe2c5-bdb2-4169-8684-1b4704b01541",
"price": {
"amount": 6480,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "private-insurance-car-standalone",
"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": "165613732",
"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": "OGY0NWFHNWMTZJUYYY00OTQXLW",
"name": "ansvar",
"deductible": 2987
},
{
"id": "NDI4YTI2MWETY2IWNC00MMEXLT",
"name": "kasko",
"deductible": 2987
},
{
"id": "ZJI5NDLLY2ITMWJINY00MTM5LT",
"name": "vejhjælp"
},
{
"id": "MDEYYTI4YMQTYTKZOC00MTVLLT",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "MMFJNTU1YTUTNMJKMI00MDA5LW",
"name": "udvidet_førerulykke"
},
{
"id": "MJLLZTU3MGUTM2JHMC00NWFJLT",
"name": "påkørsel_af_dyr"
},
{
"id": "ODAWNWM2YJQTZJUYMS00NWM4LW",
"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-standalone",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "125000"
},
"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" : {
"cvr_number":"81753512"
},
"person": {
"first_name": "Ove"
"last_name": "Brammer",
},
"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": "cd337c6e-933f-4136-8d30-a5634559aa79",
"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-standalone",
"parameters": {
"vehicle_type": "varevogn",
"vehicle_usage": "godstransport",
"vehicle_user": "organization",
"vehicle_owner": "organization",
"policy_holder": "organization",
"payments_per_year": "1",
"vehicle_price": "125000"
},
"features": [
{
"name": "premium"
}
]
},
"policies": [
{
"policy_number": "165613724",
"ipid_href": "https://www.almbrand.dk/ipid/aupr",
"insurable_object": {
"vehicle": {
"make": "VW",
"model": "Transporter",
"variant": "6.1",
"vin": "1MMBB41JXYN109186",
"registration_number": "AK47540",
"vehicle_type": "03",
"vehicle_usage": "40"
}
},
"parties" :[
{
"vehicle_owner" : true,
"policy_holder" : true,
"organization" : {
"cvr_number":"81753512"
},
"person": {
"first_name": "Ove"
"last_name": "Brammer",
},
"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 Ø"
}
}
],
"coverages": [
{
"id": "MTJJYMQXZJITNZZLYI00MZE0LW",
"name": "ansvar",
"deductible": 3585
},
{
"id": "MJAYOGQ2MDMTMJM0OS00YTM4LW",
"name": "statsafgift"
},
{
"id": "NJDMMTU3MTETYJUWNC00NZNKLT",
"name": "førerulykke"
},
{
"id": "MDHLY2U2ZGMTZGQ5NI00NWNLLT",
"name": "kasko",
"deductible": 3585
},
{
"id": "ZDY4YZMWNJMTZJFJNI00ZMM4LW",
"name": "redning_i_udlandet"
},
{
"id": "NTBLODVHOTKTZWZJYS00NWY5LW",
"name": "retshjælp",
"deductible": 2500
},
{
"id": "NDMWY2U5MJITMGU5MY00MDJKLT",
"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/f3efe2c5-bdb2-4169-8684-1b4704b01541
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": "f3efe2c5-bdb2-4169-8684-1b4704b01541",
"price": {
"amount": 6480,
"currency": "DKK",
"payments_per_year": 1,
"details": {
"skadesforsikringsafgift": "33.53",
"garantifondsbidrag": "40.00",
"miljøbidrag": "84.00"
}
},
"product": {
"product_name": "private-insurance-car-standalone",
"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": "165613732",
"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": "OGY0NWFHNWMTZJUYYY00OTQXLW",
"name": "ansvar",
"deductible": 2987
},
{
"id": "NDI4YTI2MWETY2IWNC00MMEXLT",
"name": "kasko",
"deductible": 2987
},
{
"id": "ZJI5NDLLY2ITMWJINY00MTM5LT",
"name": "vejhjælp"
},
{
"id": "MDEYYTI4YMQTYTKZOC00MTVLLT",
"name": "udvidet_glas",
"deductible": 985
},
{
"id": "MMFJNTU1YTUTNMJKMI00MDA5LW",
"name": "udvidet_førerulykke"
},
{
"id": "MJLLZTU3MGUTM2JHMC00NWFJLT",
"name": "påkørsel_af_dyr"
},
{
"id": "ODAWNWM2YJQTZJUYMS00NWM4LW",
"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/f3efe2c5-bdb2-4169-8684-1b4704b01541/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",
"quote_number" : "202 00 97 62 01",
"price" : { ...},
"product" : { ...},
"polices" : [...] ,
"agent" : { ...},
"created_at": "2020-08-26T07:59:41.364Z"
}