--- title: "Update policy" method: PATCH path: "/sales/v2/individual/travel/policies/{policy_id}" --- # Update policy `PATCH /sales/v2/individual/travel/policies/{policy_id}` ## Request - Base URL: `https://sandbox.api.axapartners.com` - URL: `https://sandbox.api.axapartners.com/sales/v2/individual/travel/policies/{policy_id}` - Auth: OAuth 2 - Client credentials - Token URL: `https://sandbox.auth.api.axapartners.com/oauth/token` scopes: `urn:axa.partners.sales.individual.travel.policies.write` 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.dev/axa-assistance/apis/axa-assistance-travel-api.md) - [All operations](https://skmtc.dev/axa-assistance/apis/axa-assistance-travel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axa-assistance/apis/axa-assistance-travel-api/revisions/700f7054c1d2?raw)