--- title: "Updates policy." method: PUT path: "/sales/v2/individual/travel/policies/{policy_id}" --- # Updates policy. `PUT /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 - `external_policy_number` string: External policy identifier that can be provided by the partner. - `subscription_country` string: Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes). - `quote_code` string, required: Quote code, partner can use a default value if provided by AXA or got it with quoting API. - `policy_start_date` string, date: The effective policy start date - ISO 8601 format (YYYY-MM-DD). - `domain_url` string: The url from the request is originated. - `sales_information` object: Sales information. - `point_of_sale` string: Point of sale of the policy. - `seller` string: Seller who sold the policy - `price` object, required: 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. - `addons` string[]: List of add-ons codes (both, regular and temporary ones), add-ons added by the customer. - `policy_holder` object, required: 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). - `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 - `consents` object[]: List of consents displayed to the customer. - `code` string, required: Code of the consent. - `is_confirmed` boolean, required: Indicates if the consent has been confirmed by the customer or not. - `payment` object: Payment information, at least one of the properties psp_transaction_id or transfer_information should be provided. - `type` 'CREDIT_CARD' | 'DEBIT_CARD' | 'ELECTRONIC_TRANSFERT' | 'VIRTUAL_CREDIT_CARD' | 'DIRECT_PAYMENT': Payment mode selected. - `psp_transaction_id` string: Payment reference on the payment provider system. - `transfer_information` object: Information about the payer. - `account_holder` object - `first_name` string: First name of the account's owner. - `last_name` string: Last name of the account's owner. - `billing_address` object - `street_address` string: Street address. - `postal_code` string: Postal code or zip code. - `city` string: City. - `country` string: Country. - `province` string: Province. - `account_name` string: Name's of this bank account - `country_code` string: Bank's country code, ISO-3166-1 alpha-2 format (2 letters code). - `wire_code` object[] - `wire_code_type` 'IBAN': Wire's type (only IBAN is accepted) - `value` string: The value of the IBAN - `additional_information` object[]: Additional information filled by the partner if needed. - `code` 'EXISTING_INSURANCE_REFERENCE' | 'REGISTRATION_PLATE_NUMBER', required: Information code. - EXISTING_INSURANCE_REFERENCE: References to existing or complementary insurance - REGISTRATION_PLATE_NUMBER: vehicle license plate reference - `value` string, required: Information value. - `has_to_send_email_immediately` boolean: Indicates if the draft email should be sent immediately. - `utm_parameters` object: UTM parameters for tracking marketing campaigns and traffic sources - `source` string: Identifies which site sent the traffic (e.g., search engine, newsletter, or other referral source). - `medium` string: Identifies the marketing medium used to reach the user (e.g., email, CPC, banner). - `campaign` string: Identifies the specific campaign name or promotion associated with the traffic. - `term` string: Identifies keywords associated with the campaign. - `content` string: Differentiates between links or ads pointing to the same URL, used for A/B testing. ## Response `200` Policy updated. - object - `policy_id` string: Unique final policy identifier. - `draft_policy_number` string: Draft policy number, provided in case if the policy is not confirmed. - `quote_code` string, required: Quote code, partner can use a default value if provided by AXA or got it with quoting API. - `policy_number` string: Final policy number. - `external_policy_number` string: External policy identifier that can be provided by the partner. - `status` object: Policy status. - `value` 'CONFIRMED' | 'DRAFT' | 'CANCELLED', required: Status value - `reason` string: Status reason. - `subscription_country` string: Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes). - `sales_information` object: Sales information. - `point_of_sale` string: Point of sale of the policy. - `seller` string: Seller who sold the policy - `price` object, required: 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. - `addons` string[]: List of add-ons codes (both, regular and temporary ones), add-ons added by the customer. - `policy_holder` object, required: 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 - `consents` object[]: List of consents displayed to the customer. - `code` string, required: Code of the consent. - `is_confirmed` boolean, required: Indicates if the consent has been confirmed by the customer or not. - `payment_technical_information` object: Technical information for payment system access. This information is provided to the API caller to allow it to complete the payment. - `zuora_access` object, required: Access information specific to Zuora. - `payment_gateway` string, required: Payment gateway code. - `key` string, required: Public key generated for the subscription. - `signature` string, required: Digital signature generated for the subscription. - `token` string, required: Token generated for the subscription. - `tenant_id` string, required: ID of the Zuora tenant. - `page_id` string, required: The page id. - `payment` object: Payment information, at least one of the properties psp_transaction_id or transfer_information should be provided. - `type` 'CREDIT_CARD' | 'DEBIT_CARD' | 'ELECTRONIC_TRANSFERT' | 'VIRTUAL_CREDIT_CARD' | 'DIRECT_PAYMENT': Payment mode selected. - `psp_transaction_id` string: Payment reference on the payment provider system. - `transfer_information` object: Information about the payer. - `account_holder` object - `first_name` string: First name of the account's owner. - `last_name` string: Last name of the account's owner. - `billing_address` object - `street_address` string: Street address. - `postal_code` string: Postal code or zip code. - `city` string: City. - `country` string: Country. - `province` string: Province. - `account_name` string: Name's of this bank account - `country_code` string: Bank's country code, ISO-3166-1 alpha-2 format (2 letters code). - `wire_code` object[] - `wire_code_type` 'IBAN': Wire's type (only IBAN is accepted) - `value` string: The value of the IBAN - `attachments` object[]: Set of attachments provided with the policy. - `name` string, required: Attached document name. - `content_url` string, required: URL to download the document. - `type` string: Indicates the type of the document, it can be: - TERMS_AND_CONDITIONS; - CONTRACT; - ... - `created_at` string, date: Date and time of document creation - ISO 8601 format (YYYY-MM-DD). - `sent_by` string[]: The attachment sent via confirmation email or precontractual email. - `technical_reference` string: The technical reference used to download the attachment. - `additional_information` object[]: Additional information filled by the partner if needed. - `code` 'EXISTING_INSURANCE_REFERENCE' | 'REGISTRATION_PLATE_NUMBER', required: Information code. - EXISTING_INSURANCE_REFERENCE: References to existing or complementary insurance - REGISTRATION_PLATE_NUMBER: vehicle license plate reference - `value` string, required: Information value. ## 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, ...) - `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)