v1

latestOpenAPI 3.0.12026-08-066103.9 MB

Updates policy.

Cf. summary

put/sales/v2/individual/travel/policies/{policy_id}

Path parameters

policy_idstring required
Example:ea45ec62-0d21-4f44-a577-b8624da2bf5b

Unique policy identifier.

Request body

external_policy_numberstring

External policy identifier that can be provided by the partner.

subscription_countrystring

Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes).

quote_codestring required

Quote code, partner can use a default value if provided by AXA or got it with quoting API.

policy_start_datestring date

The effective policy start date - ISO 8601 format (YYYY-MM-DD).

domain_urlstring

The url from the request is originated.

addonsstring[]

List of add-ons codes (both, regular and temporary ones), add-ons added by the customer.

has_to_send_email_immediatelyboolean

Indicates if the draft email should be sent immediately.

Example request

{
  "external_policy_number": "58eb265b-8175-4e46-9ece-18fb22d8ebb7",
  "subscription_country": "FR",
  "quote_code": "d41d8cd98f00b204e9800998ecf8427e",
  "policy_start_date": "2019-01-30",
  "domain_url": "https://axa.com/deeplink/route",
  "sales_information": {
    "point_of_sale": "THOMAS COOK",
    "seller": "S22NBY98"
  },
  "price": {
    "formula": "12-MONTHS",
    "currency": "EUR",
    "price_after_discount_inc_tax": 150.25
  },
  "policy_holder": {
    "title": "MR",
    "first_name": "John",
    "middle_name": "Junior",
    "last_name": "Doe",
    "birth_date": "1990-04-25",
    "email": "jonathan.doe@mail.com",
    "spoken_language": "en-US",
    "phone": {
      "international_prefix": "+33",
      "number": "12345678"
    },
    "address": {
      "street_address": "150 Avenue de Paris",
      "postal_code": "75001",
      "city": "Paris",
      "country": "FR"
    },
    "external_holder_id": "ab8b7d8b-cdc4-46fd-bc4d-4abb3743a6d8"
  },
  "beneficiaries": [
    {
      "title": "MR",
      "first_name": "John",
      "middle_name": "Junior",
      "last_name": "Doe",
      "birth_date": "1990-04-25",
      "email": "jonathan.doe@mail.com"
    }
  ],
  "motor_coverages": {
    "insured_items": {
      "vehicles": [
        {
          "registration_number": "4234BMW",
          "brand": "Volkswagen",
          "model": "Passat SW",
          "colour": "Spatial grey"
        }
      ]
    }
  },
  "payment": {
    "type": "CREDIT_CARD",
    "psp_transaction_id": "3af6781b-3f47-4d3f-ae94-0e5167c22dc3",
    "transfer_information": {
      "account_holder": {
        "first_name": "John",
        "last_name": "Doe",
        "billing_address": {
          "street_address": "150 Avenue de Paris",
          "postal_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "account_name": "Personal Account",
      "country_code": "FR",
      "wire_code": [
        {
          "value": "FR7630006000011234567890189"
        }
      ]
    }
  },
  "additional_information": [
    {
      "code": "EXISTING_INSURANCE_REFERENCE",
      "value": "A1455CDH"
    }
  ],
  "utm_parameters": {
    "source": "google",
    "medium": "cpc",
    "campaign": "spring_sale_2025",
    "term": "insurance+online",
    "content": "banner_top"
  }
}

Response

Policy updated.

policy_idstring

Unique final policy identifier.

draft_policy_numberstring

Draft policy number, provided in case if the policy is not confirmed.

quote_codestring required

Quote code, partner can use a default value if provided by AXA or got it with quoting API.

policy_numberstring

Final policy number.

external_policy_numberstring

External policy identifier that can be provided by the partner.

subscription_countrystring

Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes).

addonsstring[]

List of add-ons codes (both, regular and temporary ones), add-ons added by the customer.

Example response

{
  "policy_id": "ea45ec62-0d21-4f44-a577-b8624da2bf5b",
  "quote_code": "d41d8cd98f00b204e9800998ecf8427e",
  "subscription_country": "FR",
  "sales_information": {
    "point_of_sale": "THOMAS COOK",
    "seller": "S22NBY98"
  },
  "price": {
    "formula": "12-MONTHS",
    "currency": "EUR",
    "price_after_discount_inc_tax": 150.25
  },
  "policy_holder": {
    "title": "MR",
    "first_name": "John",
    "middle_name": "Junior",
    "last_name": "Doe",
    "birth_date": "1990-04-25",
    "email": "jonathan.doe@mail.com",
    "spoken_language": "en-US",
    "phone": {
      "international_prefix": "+33",
      "number": "12345678"
    },
    "address": {
      "street_address": "150 Avenue de Paris",
      "postal_code": "75001",
      "city": "Paris",
      "country": "FR"
    },
    "external_holder_id": "ab8b7d8b-cdc4-46fd-bc4d-4abb3743a6d8"
  },
  "beneficiaries": [
    {
      "title": "MR",
      "first_name": "John",
      "middle_name": "Junior",
      "last_name": "Doe",
      "birth_date": "1990-04-25",
      "email": "jonathan.doe@mail.com"
    }
  ],
  "motor_coverages": {
    "insured_items": {
      "vehicles": [
        {
          "registration_number": "4234BMW",
          "brand": "Volkswagen",
          "model": "Passat SW",
          "colour": "Spatial grey"
        }
      ]
    }
  },
  "payment": {
    "type": "CREDIT_CARD",
    "psp_transaction_id": "3af6781b-3f47-4d3f-ae94-0e5167c22dc3",
    "transfer_information": {
      "account_holder": {
        "first_name": "John",
        "last_name": "Doe",
        "billing_address": {
          "street_address": "150 Avenue de Paris",
          "postal_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "account_name": "Personal Account",
      "country_code": "FR",
      "wire_code": [
        {
          "value": "FR7630006000011234567890189"
        }
      ]
    }
  },
  "attachments": [
    {
      "name": "Proof of purchase",
      "content_url": "https://axa.com/deeplink/route",
      "type": "CONTRACT",
      "technical_reference": "3c13937d-9f60-4fff-bf03-06d9aee56abe"
    }
  ],
  "additional_information": [
    {
      "code": "EXISTING_INSURANCE_REFERENCE",
      "value": "A1455CDH"
    }
  ]
}