---
title: "Update policy"
method: PATCH
path: "/sales/v2/individual/travel/policies/{policy_id}"
---

# Update policy

`PATCH /sales/v2/individual/travel/policies/{policy_id}`

Cf. summary

## Path parameters

- `policy_id` string, required

## Request body

- object
  - `policy_holder` object — Policy holder
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email, required — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
    - `spoken_language` string, required — Spoken language, IANA language codification.
    - `phone` object — Phone number.
      - `international_prefix` string — Prefix to be added to be called from abroad.
      - `number` string, required — Phone number. Can be local or international.
    - `address` object — Postal address
      - `street_address` string, required — Street address.
      - `postal_code` string, required — Postal code or zip code.
      - `city` string, required — City.
      - `country` string, required — Country ISO-3166-1 alpha-2 format (2 letter codes).
    - `is_policy_beneficiary` boolean, required — Indicates if the policy holder is also a policy beneficiary.
    - `external_holder_id` string — Partner identifier of the customer.
  - `beneficiaries` object[] — Beneficiaries list (other than the policy holder if he is also a beneficiary).
    - `id` string — Beneficiary identifier.
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
  - `motor_coverages` object — Insured motor assets.
    - `insured_items` object — Beneficiaries list for motor products
      - `vehicles` object[] — Vehicle specific information
        - `registration_number` string — Car's license plate
        - `brand` string — Brand name
        - `model` string — Model
        - `colour` string — Vehicle's colour
  - `price` object — Policy price.
    - `formula` string — Formula selected by the customer.
    - `currency` string, required — Currency, ISO 4217 format (3 letter code).
    - `price_after_discount_inc_tax` number, required — Price amount discounted including taxes, numeric with 2 decimals.
    - `charge_method` 'ADDITIONAL_CHARGE_AUTO' | 'ADDITIONAL_CHARGE_REMOTE' | 'NET_ZERO' | 'PAYMENT_NOT_MANAGED_BY_AXA' | 'REFUND' — Charge/refund method selected by the customer: - ADDITIONAL_CHARGE_AUTO: Additional payment charged to original payment method. - ADDITIONAL_CHARGE_REMOTE: Additional payment to be handled by remote link payment. - NET_ZERO: No changes in price. - PAYMENT_NOT_MANAGED_BY_AXA: Payment is handled by the partner. - REFUND: Change in price favors the customer who needs to be refunded.
  - `addons` string[] — List of add-ons codes (both, regular and temporary ones), add-ons added by the customer.
  - `quote_code` string — New quote code provided by quoting API. Only for draft policies.
  - `payment` object — Payment
    - `bad_debt` object — If amount property is set to `null`, then policy is out of bad debt. Otherwise, please specify the bad debt value and currency
      - `amount` object, nullable, required — Bad debt amount. If amount property is set to `null`, then policy is out of bad debt. Otherwise, please specify the bad debt value and currency
        - `value` number, required — Amount, numeric, with 2 or 3 decimals. Only negative values, `0` (zero) is not accepted
        - `currency` string, required — Currency of the amount. ISO 4217 format (3 letter code).
      - `effective_date` string, date, required — Date when the bad debt update needs to be reflected, is today or in the past - ISO 8601 format (YYYY-MM-DD).

## Response `204`

Patch successfully done (No content returned).

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized. The identity of the caller has not been definitely confirmed (invalid issuer, expired token, ...)
- `403` — Forbidden. The identity of the caller is confirmed, however the required access grants are not met (missing scope, unknown client_id, ...)
- `404` — Not found. The server did not find a current representation for the searched resource.
- `409` — Conflict. The request could not be completed due to a conflict with the current state of the resource.
- `default` — Default response format.

---

[API](https://skmtc.net/axa-assistance/apis/untitled-api.md) · [All operations](https://skmtc.net/axa-assistance/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axa-assistance/untitled-api/revisions/efe32b811f1d/schema)