Secret Escapes

Create booking

POST /api/partners/{partner_id}/quotes/{quote_id}/bookings

The Create Booking API endpoint allows partners to convert a quote into a booking. Partners can provide necessary details about the policyholder and insured parties to finalise the booking process. This endpoint requires a valid access token obtained from the Authentication.

Path parameters

Parameter
Type
Description

partner_id

string

The partner identifier provided during onboarding

quote_id

string

Unique identifier of the quote returned in the widget

Headers

Name
Value

Accept

application/json

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

policy_holder.first_name

string

First name

policy_holder.last_name

string

Last name

policy_holder.country

string

Two letters country code

policy_holder.email

string

Email address

policy_holder.phone

string

Phone number

policy_holder.address1

string

Address line 1

policy_holder.address2

string

Address line 2

policy_holder.city

string

City of residence

policy_holder.region

string

Region

policy_holder.postcode

string

Postcode

quotes

array

quotes[].id

string

Unique identifier of the quote policy

quotes[].brightwrite_details.bw_experiment_id

string

ID of the BrightWrite experiment

quotes[].brightwrite_details.bw_variant_id

string

ID of the experiment variant generated for the customer

quotes[].brightwrite_details.bw_device_id

string

ID of the customer device

quotes[].insured

array

A list of insured

quotes[].insured[].first_name

string

First name

quotes[].insured[].last_name

string

Last name

quotes[].insured[].email

string

Email address

quotes[].insured[].country

string

Two letters country code

quotes[].insured[].address1

string

Address line 1

quotes[].insured[].address2

string

Address line 2

quotes[].insured[].city

string

City of residence

quotes[].insured[].region

string

Region

quotes[].insured[].postcode

string

Postcode

quotes[].insured[].phone

string

Phone number

quotes[].insured[].birth_date

string

Date of birth

quotes[].insured[].company

string

Company name

{
    "policy_holder": {
        "first_name": "Kaitlin",
        "last_name": "Brown",
        "country": "AU",
        "email": "[email protected]",
        "phone": "+1-630-477-5267",
        "address1": "50827 Halvorson Way"
        "city": "Sydney",
        "region": "NSW",
        "postcode": "68988-3838"
    },
    "quotes": [
        {
            "id": "9696f4be-0938-4e1e-9915-b8caf116b223",
            "insured":
            [
                {
                    "first_name": "Kaitlin",
                    "last_name": "Brown",
                    "email": "[email protected]",
                    "country": "AU",
                    "address1": "50827 Halvorson Way",
                    "city": "Sydney",
                    "region": "NSW",
                    "postcode": "68988-3838",
                    "phone": "+1-630-477-5267",
                    "birth_date": "1953-06-23",
                    "company": "Gibson LLC"
                }
            ]
        }
    ]
}

Response

{
    "data": {
        "provider_reference": "C9374-R2G3K-INS",
        "language": "en",
        "provider_customer_id": null,
        "status": "Active",
        "currency": "EUR",
        "price": 52.88,
        "security_token": "09FM9-WDaCw-QUJBb-1tlqM",
        "created_at": "2024-07-21T09:54:52.000000Z",
        "updated_at": "2024-07-21T09:54:52.000000Z",
        "is_instant_booking": false,
        "policies": [
            {
                "status": "Active",
                "policy_start_date": "2024-07-21T00:00:00.000000Z",
                "policy_end_date": "2024-08-30T00:00:00.000000Z",
                "price": 52.88,
                "tax": 2.88,
                "commission": 21.25,
                "cover_amount": null,
                "policy_type": "comprehensive_travel_insurance",
                "policy_code": "CN02AME",
                "policy_version": "44349651-f6c2-469e-ae38-3ef2d5728515",
                "policy_content": {
                    "title": "Comprehensive Travel Insurance",
                    "header": null,
                    "description": "-",
                    "optout_msg": "",
                    "inclusions": [],
                    "exclusions": [],
                    "disclaimer": "This policy is provided by Cover Genius Europe B.V. and underwritten by Cowen Insurance Company Ltd. By adding protection you confirm you have read and agree to the Policy Terms and Insurance Product Information Document. You agree to receive the policy documentation electronically.Cover Genius Europe B.V. is registered at the Dutch Chamber of Commerce under number 73237426 and licensed as an insurance intermediary and authorised agent at the Dutch Authority for the Financial Markets under license number 12046177. XCover.com is a trading name of Cover Genius Europe B.V.Cowen Insurance Company Ltd, bearing Malta Company Registration Number C55905, is a Company authorised by the Malta Financial Services Authority (MFSA) to carry out general Insurance business under the insurance business act, 1998, of the laws of Malta. HomeToGo GmbH is an Ancillary Insurance Intermediary of Cover Genius Europe B.V.",
                    "disclaimer_html": "<p data-block-key=\"3amlk\">This policy is provided by Cover Genius Europe B.V. and underwritten by Cowen Insurance Company Ltd. By adding protection you confirm you have read and agree to the <a href=\"https://www.xcover.com/en/pds/C9374-R2G3K-INS?policy_type=comprehensive_travel_insurance_v2\" rel=\"noopener noreferrer\" target=\"_blank\">Policy Terms</a> and <a href=\"https://static.xcover.com/media/pds/cea422a7-e2db-4dca-9f42-be7362405e25/IPID_Comprehensive_EN.pdf\" rel=\"noopener noreferrer\" target=\"_blank\">Insurance Product Information Document</a>. You agree to receive the policy documentation electronically.</p><p data-block-key=\"37q1a\">Cover Genius Europe B.V. is registered at the Dutch Chamber of Commerce under number 73237426 and licensed as an insurance intermediary and authorised agent at the Dutch Authority for the Financial Markets under license number 12046177. XCover.com is a trading name of Cover Genius Europe B.V.</p><p data-block-key=\"bvj7t\">Cowen Insurance Company Ltd, bearing Malta Company Registration Number C55905, is a Company authorised by the Malta Financial Services Authority (MFSA) to carry out general Insurance business under the insurance business act, 1998, of the laws of Malta. HomeToGo GmbH is an Ancillary Insurance Intermediary of Cover Genius Europe B.V.</p>",
                    "payment_disclaimer": "",
                    "in_path_disclaimer": "",
                    "extra_content": []
                },
                "claim_selector_id": null,
                "pds_url": "https://www.xcover.com/en/pds/C9374-R2G3K-INS?policy_type=comprehensive_travel_insurance_v2",
                "extra_fields": {
                    "bundled_retail_premium": "52.87999999999999920993754010"
                },
                "confirmed_at": "2024-07-21T09:54:52.000000Z",
                "cancelled_at": null,
                "created_at": "2024-07-21T09:54:52.000000Z",
                "updated_at": "2024-07-21T09:54:52.000000Z",
                "id": "40221b50-9da8-4806-80b6-0e96d87990fb"
            }
        ],
        "policyholder": {
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "+1-630-477-5267",
            "country": "FR",
            "date_of_birth": null,
            "address1": "50827 Halvorson Way",
            "address2": null,
            "city": "Sydney",
            "region": "NSW",
            "postcode": "68988-3838",
            "created_at": "2024-07-21T09:54:52.000000Z",
            "updated_at": "2024-07-21T09:54:52.000000Z",
            "id": "daad905a-5e21-46a3-972a-9e3e93a730a5"
        },
        "id": "d84a913c-331f-4983-9474-1257a0d966bb",
        "partner": {
            "uuid": "4f607e20-bfa6-4d46-8f6b-462bc970be9d",
            "name": "Secret Escapes"
        },
        "quote": {
            "uuid": "2abf21c2-831b-490d-bed2-7338f0096dc5"
        },
        "cancellations": []
    }
}

PreviousFreshtixNextModify booking

Last updated