Confirm Offer

Confirm Offer

post

Finalize the purchase of event ticket protection. Converts the selected Offer into a confirmed booking after payment.

Idempotency

Supports x-idempotency-key header for safe retries.

Authorizations

AuthorizationstringRequired

Composite Authentication Scheme (Client Key, Date, and Signature)

Requires three mandatory headers in every request:

1. X-Api-Key (Client Key)

• Purpose: Public identifier for the API consumer.

2. Date (Timestamp)

• Purpose: Timestamp used for generating the signature and preventing replay attacks.
• Format: RFC 7231 format (e.g., in GMT).

3. Authorization (Computed Signature)

• Purpose: Cryptographic signature that verifies the request's authenticity and integrity.
• Format: SIGNATURE [authHeader]

The authHeader value is derived from a cryptographic hash (e.g., HMAC-SHA256) of canonical request components (HTTP Method, Path, and the contents of the Date header), signed with the private Client Secret.

Path parameters

partner_codestringRequired

offer_idstringRequired

The offer ID returned from the Create Offer endpoint.

Header parameters

x-idempotency-keystring · uuidOptional

Body

Responses

200

OK

application/json

idstringOptional

statusstringOptional

currencystringOptional

total_pricenumberOptional

total_price_formattedstringOptional

partner_transaction_idstring · nullableOptional

created_atstring · date-timeOptional

updated_atstring · date-timeOptional

pds_urlstring · uriOptional

security_tokenstringOptional

total_taxnumberOptional

total_tax_formattedstringOptional

total_premiumnumberOptional

total_premium_formattedstringOptional

fnol_linkstring · uriOptional

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict - Duplicate Request (Idempotent)

application/json

422

Unprocessable Entity

application/json

423

Locked - Request In Progress

application/json

post/partners/{partner_code}/offers/{offer_id}/confirm/

POST /x/partners/{partner_code}/offers/{offer_id}/confirm/ HTTP/1.1
Host: api.xcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 236

{
  "quotes": [
    {
      "id": "78e02aeb-86fa-47e1-b1b7-e0f12b734c5a"
    }
  ],
  "policyholder": {
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "[email protected]",
    "address1": "350 5th Avenue",
    "city": "New York",
    "region": "NY",
    "postcode": "10036",
    "country": "US"
  }
}

{
  "id": "ETP9K-4MR2N-INS",
  "status": "CONFIRMED",
  "currency": "USD",
  "total_price": 123.68,
  "total_price_formatted": "US$123.68",
  "partner_transaction_id": null,
  "created_at": "2025-12-02T23:00:00.000000Z",
  "updated_at": "2025-12-02T23:00:00.150000Z",
  "pds_url": "https://www.xcover.com/en/pds/ETP9K-4MR2N-INS",
  "security_token": "4kLqX-9PrLm-bcDjK-72NM4",
  "quotes": [
    {
      "id": "78e02aeb-86fa-47e1-b1b7-e0f12b734c5a",
      "policy_start_date": "2025-12-02T22:58:15.061427+00:00",
      "policy_end_date": "2025-12-07T16:00:00+00:00",
      "status": "CONFIRMED",
      "price": 123.68,
      "price_formatted": "US$123.68",
      "policy": {
        "policy_type": "event_ticket_protection",
        "policy_type_version": "1",
        "policy_type_slug": "event_ticket_protection_v1",
        "policy_type_group_name": "events",
        "policy_name": "ACME Events Ticket Protection",
        "policy_code": "AETP0001",
        "policy_version": "d09c2b37-bb8c-41ae-b281-58d99bd13ede",
        "category": "event_ticket_protection",
        "policy_currency": "USD"
      },
      "tax": {
        "total_tax": 0,
        "total_amount_without_tax": 123.68,
        "total_tax_formatted": "US$0.00",
        "total_amount_without_tax_formatted": "US$123.68"
      },
      "benefits": [],
      "commission": {
        "partner_commission": 0,
        "total_commission": 0,
        "partner_commission_formatted": "US$0.00",
        "total_commission_formatted": "US$0.00"
      },
      "created_at": "2025-12-02T23:00:00.000000Z",
      "confirmed_at": "2025-12-02T23:00:00.150000Z",
      "pds_url": "https://www.xcover.com/en/pds/ETP9K-4MR2N-INS?policy_type=event_ticket_protection_v1&quote_id=78e02aeb-86fa-47e1-b1b7-e0f12b734c5a",
      "can_be_cancelled": true
    }
  ],
  "coi": {
    "url": "https://www.xcover.com/en/coi/ETP9K-4MR2N-INS?security_token=4kLqX-9PrLm-bcDjK-72NM4",
    "pdf": "https://www.xcover.com/en/coi/ETP9K-4MR2N-INS.pdf?security_token=4kLqX-9PrLm-bcDjK-72NM4"
  },
  "policyholder": {
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "[email protected]",
    "country": "US"
  },
  "total_tax": 0,
  "total_tax_formatted": "US$0.00",
  "total_premium": 123.68,
  "total_premium_formatted": "US$123.68",
  "fnol_link": "https://www.xcover.com/en/account/claims/fnol?bookingID=ETP9K-4MR2N-INS&security_token=4kLqX-9PrLm-bcDjK-72NM4"
}