Quotes

Quote API endpoints can be used to request and modify policies for specific customers.

Opt-out

Report conversion of the main product without ancillary insurance products

path Parameters
partner_id
required
string
quote_package_id
required
string
Request Body schema: application/json
partner_metadata
object (Partner metadata)

This field takes partner-specific fields. The keys represent field names and can be any arbitrary string.The values must be one of the simple JSON types: string, boolean, number or null. It’s impossible to use complex types i.e. objects and arrays.

Responses

204

Request Succeeded

404

Unknown partner or booking, or booking does not belong to the partner

422
post/partners/{partner_id}/bookings/{quote_package_id}/opt_out
https://eu-central-1.staging.api.xcover.com/api/v2/partners/{partner_id}/bookings/{quote_package_id}/opt_out

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "partner_metadata": { }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "type": "string",
  • "message": "string",
  • "code": "string",
  • "href": "string",
  • "errors":
    {
    }
}

Create quote

Create a quote with provided parameters

path Parameters
partner_id
required
string
Request Body schema: application/json
currency
required
string (Currency)
Enum: "AUD" "NZD" "USD" "EUR" "GBP" "JPY" "ZAR" "CAD" "CNY" "ARS" "BSD" "BGN" "BRL" "CLP" "KWD" "COP" "HRK" "CZK" "DKK" "EGP" "HKD" "HUF" "ISK" "INR" "IDR" "ILS" "KZT" "KRW" "CHF" "MYR" "MUR" "MXN" "NOK" "PHP" "PLN" "QAR" "RON" "RUB" "SAR" "RSD" "SGD" "SEK" "TWD" "THB" "TRY" "UAH" "VND" "AED" "MAD" "PEN" "UYU"
request
required
Array of objects (PolicyRequest)
customer_country
required
string (Customer country)
Enum: "AF" "AX" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BQ" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "CV" "KH" "CM" "CA" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "CI" "HR" "CU" "CW" "CY" "CZ" "DK" "DJ" "DM" "DO" "EC" "EG" "SV" "GQ" "ER" "EE" "SZ" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GO" "GR" "GL" "GD" "GP" "GU" "GT" "GG" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IM" "IL" "IT" "JM" "JP" "JE" "JO" "KZ" "KE" "KI" "XK" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MK" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "ME" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "KP" "MP" "NO" "OM" "PK" "PW" "PS" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "BL" "SH" "KN" "LC" "MF" "PM" "VC" "WS" "SM" "ST" "SA" "SN" "RS" "SC" "SL" "SG" "SX" "SK" "SI" "SB" "SO" "ZA" "GS" "KR" "SS" "ES" "LK" "SD" "SR" "SJ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TL" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "UM" "US" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "ZM" "ZW"
customer_region
string (Customer region) <= 32 characters Nullable

Country subdivision where the customer resides (as defined by ISO-3166-2, e.g. state or territory for Australia "NSW", "VIC", "ACT", "NT", etc

customer_language
string (Customer language)
Enum: "en" "de" "fr" "nl" "es" "it" "zh" "zh-hans" "zh-hant" "pt-br" "pl" "he" "pt" "sv" "ja" "ko" "da" "no" "fi" "ar" "tr" "cs" "ru" "th" "bg" "ca" "hr" "et" "el" "hu" "is" "id" "lv" "lt" "ms" "tl" "ro" "sr" "sk" "sl" "sw" "uk" "vi" "en-us" "be"

Customer's language

customer_email
string <email> (Customer email) <= 254 characters Nullable

Email address of the customer

customer_ip
string (Customer ip) non-empty Nullable
customer_postcode
string (Customer postcode) <= 16 characters Nullable
partner_subsidiary
string (Partner subsidiary) <= 128 characters Nullable

Subsidiary of the Partner if applicable

partner_transaction_id
string (Partner transaction id) <= 1024 characters Nullable

Transaction ID as it appears in the partner's database (e.g. booking id, order id)

partner_customer_id
string (Partner customer id) <= 1024 characters Nullable

Partner's customer ID for this transaction

partner_metadata
object (Partner metadata)

This field can be used to pass custom information along with the quote request. The value of this field should be a JSON object representing key-value pairs with a string, boolean or number as a value. Complex data types like objects or array are not allowed.

opt_out
boolean (Opt out)
Default: false

Should the created quote be automatically opted out (no booking can be made)

Responses

201
404

Unknown partner

422

Quote params are incorrect or quote cannot be processed.

post/partners/{partner_id}/quotes/
https://eu-central-1.staging.api.xcover.com/api/v2/partners/{partner_id}/quotes/

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currency": "AUD",
  • "request":
    [
    ],
  • "customer_country": "AF",
  • "customer_region": "string",
  • "customer_language": "en",
  • "customer_email": "[email protected]",
  • "customer_ip": "string",
  • "customer_postcode": "string",
  • "partner_subsidiary": "string",
  • "partner_transaction_id": "string",
  • "partner_customer_id": "string",
  • "partner_metadata": { },
  • "opt_out": false
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": "string",
  • "status": "string",
  • "currency": "str",
  • "total_price": 0,
  • "total_price_formatted": "string",
  • "partner_transaction_id": "string",
  • "created_at": "2020-07-04T16:11:08Z",
  • "updated_at": "2020-07-04T16:11:08Z",
  • "pds_url": "http://example.com",
  • "security_token": "string",
  • "quotes":
    {