Create a new quote
POST/quotes/:market/:productType
Create a quote request
Request
Path Parameters
Market
product Type
- application/json
Body
required
Params and values to request a new quote
Array [
]
Callback URL to be called when the quote is updated on bolttech side.
params
object[]
required
Responses
- 201
- 401
Successful operation
- application/json
- Schema
- Example (from schema)
- car-insurance
Schema
Array [
Array [
]
Array [
]
]
Additional details that do not have a specific field to store it.
Indicates whether the quote process has been completed
Timestamp when the quote was created
References to external systems or identifiers
products
object[]
Unique internal identifier for the product
Additional metadata associated with the product
Name of the product
price
object
commission
object
Additional details that do not have a specific field to store it.
Possible values: [FIXED, PERCENTAGE]
Tax rate
Possible values: [AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, USS, UYI, UYU, UZS, VEF, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XFU, XOF, XPD, XPF, XPT, XTS, XXX, YER, ZAR, ZMW]
Currency codes Enum
discount
object[]
Additional details that do not have a specific field to store it.
Possible values: [FIXED, PERCENTAGE]
Tax rate
premium
object
taxes
object[]
Human readable description of the tax
Type/category of the tax being applied
Numeric value of the amount
Tax rate
General product identifier
Package identifier that the product belongs to
Quote identifier
Current status of the product
Provider identifier for the product
Product rating or score value
Status of each provider in the quote process
Unique identifier for the quote
{
"additional_details": {},
"completed": true,
"created_at": "2024-01-01T10:30:00Z",
"external_references": {
"crm_id": "CRM123",
"external_quote_id": "EXT456"
},
"market": "string",
"products": [
{
"internal_id": "123e4567",
"internal_products": [
null
],
"metadata": {
"productGradeLabel": "gold"
},
"name": "Car Insurance Gold",
"price": {
"amount": 0,
"commission": {
"additional_details": {},
"apply_over_taxes": true,
"commission_value": 0,
"description": "string",
"type": "FIXED",
"value": "string",
"rate": 20
},
"currency_code": "EUR",
"discount": [
{
"additional_details": {},
"apply_over_taxes": true,
"commission_value": 0,
"description": "string",
"type": "FIXED",
"value": "string",
"rate": 20
}
],
"premium": {
"net": 0,
"total": 0
},
"taxes": [
{
"description": "Value Added Tax",
"type": "VAT",
"value": 0.19,
"rate": 20
}
]
},
"product_id": "PROD-001",
"product_package": "car-insurance",
"quote_id": "123456",
"product_status": "production",
"provider": "provider123",
"score": 4.5
}
],
"providerStatus": "{ \"message\": { \"min\": \"voluntaryExcess must not be less than 300\" }, \"name\": \"singlife\", \"status\": \"ERROR\", }",
"quote_id": "BR_123456789"
}
{
"completed": {
"type": "boolean",
"description": "Indicates whether the quote process has been completed.",
"example": false
},
"created_at": {
"type": "string",
"description": "Timestamp when the quote was created.",
"example": "2025-05-28T16:55:05.730+00:00"
},
"external_references": {
"type": "object",
"description": "References to external systems or identifiers.",
"properties": {
"external_quote_id": {
"type": "string",
"description": "External quote identifier.",
"example": "XXX123"
}
}
},
"products": {
"type": "array",
"description": "List of products included in the quote.",
"items": {
"properties": {
"internal_id": {
"description": "Unique internal identifier for the product",
"type": "string",
"example": "123e4567"
},
"internal_products": {
"items": "circular(Product)",
"type": "array"
},
"metadata": {
"type": "object",
"description": "Additional metadata associated with the product",
"example": {
"productGradeLabel": "gold"
}
},
"name": {
"type": "string",
"description": "Name of the product",
"example": "Car Insurance Gold"
},
"price": {
"properties": {
"amount": {
"format": "float",
"type": "number"
},
"commission": {
"properties": {
"additional_details": {
"description": "Additional details that do not have a specific field to store it.",
"type": "object"
},
"apply_over_taxes": {
"type": "boolean"
},
"commission_value": {
"format": "float",
"type": "number"
},
"description": {
"type": "string"
},
"type": {
"enum": [
"FIXED",
"PERCENTAGE"
],
"type": "string"
},
"value": {
"type": "string"
},
"rate": {
"type": "number",
"description": "Tax rate",
"example": 20
}
},
"type": "object",
"title": "SharedFee"
},
"currency_code": {
"description": "Currency codes Enum",
"enum": [
"AED",
"AFN",
"ALL",
"AMD",
"ANG",
"AOA",
"ARS",
"AUD",
"AWG",
"AZN",
"BAM",
"BBD",
"BDT",
"BGN",
"BHD",
"BIF",
"BMD",
"BND",
"BOB",
"BOV",
"BRL",
"BSD",
"BTN",
"BWP",
"BYR",
"BZD",
"CAD",
"CDF",
"CHE",
"CHF",
"CHW",
"CLF",
"CLP",
"CNY",
"COP",
"COU",
"CRC",
"CUC",
"CUP",
"CVE",
"CZK",
"DJF",
"DKK",
"DOP",
"DZD",
"EGP",
"ERN",
"ETB",
"EUR",
"FJD",
"FKP",
"GBP",
"GEL",
"GHS",
"GIP",
"GMD",
"GNF",
"GTQ",
"GYD",
"HKD",
"HNL",
"HRK",
"HTG",
"HUF",
"IDR",
"ILS",
"INR",
"IQD",
"IRR",
"ISK",
"JMD",
"JOD",
"JPY",
"KES",
"KGS",
"KHR",
"KMF",
"KPW",
"KRW",
"KWD",
"KYD",
"KZT",
"LAK",
"LBP",
"LKR",
"LRD",
"LSL",
"LTL",
"LVL",
"LYD",
"MAD",
"MDL",
"MGA",
"MKD",
"MMK",
"MNT",
"MOP",
"MRO",
"MUR",
"MVR",
"MWK",
"MXN",
"MXV",
"MYR",
"MZN",
"NAD",
"NGN",
"NIO",
"NOK",
"NPR",
"NZD",
"OMR",
"PAB",
"PEN",
"PGK",
"PHP",
"PKR",
"PLN",
"PYG",
"QAR",
"RON",
"RSD",
"RUB",
"RWF",
"SAR",
"SBD",
"SCR",
"SDG",
"SEK",
"SGD",
"SHP",
"SLL",
"SOS",
"SRD",
"SSP",
"STD",
"SYP",
"SZL",
"THB",
"TJS",
"TMT",
"TND",
"TOP",
"TRY",
"TTD",
"TWD",
"TZS",
"UAH",
"UGX",
"USD",
"USN",
"USS",
"UYI",
"UYU",
"UZS",
"VEF",
"VND",
"VUV",
"WST",
"XAF",
"XAG",
"XAU",
"XBA",
"XBB",
"XBC",
"XBD",
"XCD",
"XDR",
"XFU",
"XOF",
"XPD",
"XPF",
"XPT",
"XTS",
"XXX",
"YER",
"ZAR",
"ZMW"
],
"example": "EUR",
"type": "string",
"title": "CurrencyCodeEnum"
},
"discount": {
"items": {
"properties": {
"additional_details": {
"description": "Additional details that do not have a specific field to store it.",
"type": "object"
},
"apply_over_taxes": {
"type": "boolean"
},
"commission_value": {
"format": "float",
"type": "number"
},
"description": {
"type": "string"
},
"type": {
"enum": [
"FIXED",
"PERCENTAGE"
],
"type": "string"
},
"value": {
"type": "string"
},
"rate": {
"type": "number",
"description": "Tax rate",
"example": 20
}
},
"type": "object",
"title": "SharedFee"
},
"type": "array"
},
"premium": {
"properties": {
"net": {
"format": "float",
"type": "number"
},
"total": {
"format": "float",
"type": "number"
}
},
"type": "object",
"title": "Premium"
},
"taxes": {
"items": {
"properties": {
"description": {
"type": "string",
"description": "Human readable description of the tax",
"example": "Value Added Tax"
},
"type": {
"type": "string",
"description": "Type/category of the tax being applied",
"example": "VAT"
},
"value": {
"format": "float",
"type": "number",
"description": "Numeric value of the amount",
"example": 0.19
},
"rate": {
"type": "number",
"description": "Tax rate",
"example": 20
}
},
"type": "object",
"title": "Tax"
},
"type": "array"
}
},
"type": "object",
"title": "Price"
},
"product_id": {
"type": "string",
"description": "General product identifier",
"example": "PROD-001"
},
"product_package": {
"type": "string",
"description": "Package identifier that the product belongs to",
"example": "car-insurance"
},
"quote_id": {
"type": "string",
"description": "Quote identifier",
"example": "123456"
},
"product_status": {
"readOnly": true,
"type": "string",
"description": "Current status of the product",
"example": "production"
},
"provider": {
"type": "string",
"description": "Provider identifier for the product",
"example": "provider123"
},
"score": {
"type": "number",
"description": "Product rating or score value",
"example": 4.5
}
},
"type": "object",
"title": "Product"
},
"example": []
},
"providerStatus": {
"type": "array",
"description": "Status of each provider in the quote process.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the provider.",
"example": "singlife"
},
"status": {
"type": "string",
"description": "Status of the provider.",
"example": "ERROR"
},
"message": {
"type": "object",
"description": "Additional details about the provider status.",
"example": {
"min": "voluntaryExcess must not be less than 300"
}
}
}
},
"example": []
},
"quote_id": {
"type": "string",
"readOnly": true,
"description": "Unique identifier for the quote.",
"example": "BR_8a69e19d522f453ea4f5efc4aa12b12f"
}
}
Unauthorized