Confirm offer

The Confirm Offer endpoint is the finalization step in the Offer Management flow. It is responsible for securing the products specified in a previously created offer.

It converts an accepted Offer into a confirmed Booking, securing the selected products (insurance and/or other services) and initiating the post-purchase management lifecycle.

Confirm offer

post

Required scopes

This endpoint requires the following scopes:

• : Permission to opt-out existing offers.

Authorizations

PartnerPrivateAPI

OAuth2clientCredentialsRequired

XONE API Access Token

To get started with the XONE API, you'll first need to obtain an access token. This token acts as a digital key, granting your application permission to make API calls.

This process uses the OAuth 2.0 Client Credentials Grant flow. You'll use your unique client ID and client secret to request a token, which you then include in subsequent API requests.

🔑 Authentication Steps

• Request Token: Send a "Retrieve Token" request to the XONE authorization server's token endpoint.
• Include Credentials: In the request body, provide your client_id and client_secret as a JSON object.
• Use Token: The server will respond with an access_token that you can now use to authenticate your API calls by including it in the Authorization header as a Bearer token.

Token URL:

Path parameters

partner_idstringRequired

offer_idstringRequired

Body

application/json

Responses

200

200 OK

application/json

401

401 Unauthorized

application/json

post

/api/partners/{partner_id}/offers/{offer_id}

HTTPcURLJavaScriptPython

POST /api/partners/{partner_id}/offers/{offer_id} HTTP/1.1
Host: api.xone.xcover.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 456

{
  "quotes": [
    {
      "id": "text",
      "brightwrite_details": {
        "bw_experiment_id": "text",
        "bw_variant_id": "text",
        "bw_device_id": "text"
      },
      "insured": [
        {
          "first_name": "text",
          "last_name": "text",
          "country": "text",
          "email": "text",
          "phone": "text",
          "address1": "text",
          "city": "text",
          "region": "text",
          "postcode": "text"
        }
      ]
    }
  ],
  "policyholder": {
    "first_name": "text",
    "last_name": "text",
    "country": "text",
    "email": "text",
    "phone": "text",
    "address1": "text",
    "city": "text",
    "region": "text",
    "postcode": "text"
  }
}

{
  "data": {
    "id": "text",
    "offer_id": "text",
    "provider_reference": "text",
    "language": "text",
    "provider_customer_id": null,
    "status": "text",
    "currency": "text",
    "price": 1,
    "security_token": "text",
    "created_at": "2025-11-20T11:50:01.452Z",
    "updated_at": "2025-11-20T11:50:01.452Z",
    "is_instant_booking": true,
    "payment_status": null,
    "policies": [
      {
        "status": "text",
        "policy_start_date": "2025-11-20T11:50:01.452Z",
        "policy_end_date": "2025-11-20T11:50:01.452Z",
        "price": 1,
        "tax": 1,
        "commission": 1,
        "cover_amount": null,
        "policy_type": "text",
        "policy_code": "text",
        "policy_version": "text",
        "policy_content": {
          "title": "text",
          "header": "text",
          "description": "text",
          "optout_msg": "text",
          "inclusions": [
            "text"
          ],
          "exclusions": [
            "text"
          ],
          "disclaimer": "text",
          "disclaimer_html": "text",
          "payment_disclaimer": "text",
          "in_path_disclaimer": "text",
          "extra_content": []
        },
        "claim_selector_id": "text",
        "pds_url": "https://example.com",
        "extra_fields": {
          "seller_entity": "text",
          "event_datetime": "2025-11-20T11:50:01.452Z",
          "event_cost": null,
          "retail_price": 1,
          "uw_fee": 1,
          "reinsurer_fee": 1,
          "partner_commission": 1,
          "coverage_group": "text",
          "cg_booking_fee": 1
        },
        "confirmed_at": "2025-11-20T11:50:01.452Z",
        "cancelled_at": null,
        "created_at": "2025-11-20T11:50:01.452Z",
        "updated_at": "2025-11-20T11:50:01.452Z",
        "policy_start_date_tz_offset": "text",
        "policy_end_date_tz_offset": "text",
        "parent_id": null,
        "id": "text"
      }
    ],
    "policyholder": {
      "first_name": "text",
      "last_name": "text",
      "email": "[email protected]",
      "phone": "text",
      "country": "text",
      "birth_date": null,
      "address1": "text",
      "address2": null,
      "city": "text",
      "region": "text",
      "postcode": "text",
      "created_at": "2025-11-20T11:50:01.452Z",
      "updated_at": "2025-11-20T11:50:01.452Z",
      "id": "text"
    },
    "quote": {
      "uuid": "text"
    },
    "coi": {
      "url": "https://example.com",
      "pdf": "https://example.com"
    },
    "account_url": "https://example.com",
    "fnol_link": "https://example.com",
    "sign_up_url": "https://example.com"
  }
}