---
title: "Gets policy details."
method: GET
path: "/sales/v2/individual/travel/policies/{policy_id}"
---

# Gets policy details.

`GET /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.read_only`

Cf. summary

## Path parameters

- `policy_id` string, required

## Headers

- `accept-language` string
- `x-axa-context` string, JSON Web Token RFC 7519
- `x-tenant-id` string

## Response `200`

Policy details.

- object
  - `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).
  - `transactions` object[]: All the policy transactions.
    - `transaction_id` string: Transaction identifier.
    - `type` 'PAYMENT' | 'REFUND': The transaction type. PAYMENT = Payment REFUND = Reimbursement
    - `status` 'PROCESSING' | 'PROCESSED' | 'CANCELLED' | 'ERROR': Status of the transaction. PROCESSING = The transaction is being processed. ERROR = The transaction failed. PROCESSED = The transaction is validated. CANCELLED = The transaction is cancelled.
    - `amount` object: Total amount of the transaction.
      - `value` number, required: Amount, numeric, with 2 or 3 decimals.
      - `currency` string, required: Currency of the amount. ISO 4217 format (3 letter code).
    - `processed_at` string, date: The transaction processed date.
  - `policy_id` string: Unique final policy identifier.
  - `draft_policy_number` string: Draft policy number, provided in case if the policy is not confirmed.
  - `cancellation_date` string, date: Cancellation date of the policy - ISO 8601 format (YYYY-MM-DD).
  - `purchase_date` string, date: The date of the subscription (purchase) of the policy - ISO 8601 format (YYYY-MM-DD).
  - `coverage_period` object: The coverage period - ISO 8601 format (YYYY-MM-DD). The coverage start date is the date when it becomes possible for the customer to submit a claim. The coverage end date is the date after which the coverage ends.
    - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
    - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
  - `effective_period` object: The effective period - ISO 8601 format (YYYY-MM-DD) The start date indicates when the contract is starting = activation date. The end date indicates when the contract is ending. If the policy is cancelled, then the field is updated
    - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
    - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
  - `contracting_actor_name` string: The legal entity relied to the customer.
  - `editable_version` 'SOLD_AS' | 'LATEST': Version of the catalog to use in case of policy edit. - SOLD_AS: use the version of the catalog the policy was sold under. - LATEST: use the latest version of the catalog.
  - `legal_withdrawal_period` string: The legal withdrawal period ISO 8601 format (P5Y8M4D).
  - `legal_withdrawal_date` string, date: The last date when the user still has a legal right to cancel the policy without penalty - ISO 8601 format (YYYY-MM-DD).
  - `catalog` object: The product catalog.
    - `code` string, required: The code of the product catalog relied to the policy
    - `version` string, required: Catalog version.
    - `country` string: Origin country, ISO-3166-1 alpha-2 format (2 letter codes).
    - `currency` string: Currency, ISO 4217 format (3 letter code).
  - `guarantees` object[]: Set of guarantees included in the product.
    - `code` string: Guarantee code.
    - `label` string: Guarantee label.
    - `is_sub_guarantee` boolean: True if it's a sub guarantee, false if not.
  - `product` object: Product information.
    - `code` string: Product code
    - `name` string: Product name
    - `headline` string: Product marketing title.
    - `description` string: Product marketing description.
    - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
    - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
    - `total_discount` number: Total amount of discount, numeric with 2 decimals.
    - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
    - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `sub_category` string: Product sub category.
    - `promo_code` string: Promotion code provided on the product on which it has been applied.
    - `guarantee_class_prices` object[]: The list of class of guarantees and their impact on the product price.
      - `code` string: Guarantee class code.
      - `label` string: Guarantee class label.
      - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `coverage_repartition` object[]: The list of coverage repartition and their impact on the product price.
      - `category` string: Description of the category of the coverage repartition.
      - `gross_premium` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `tax_amount` number: Total amount of taxes, numeric with 2 decimals.
      - `tax_type` string: Description of the tax type affected on this coverage.
      - `label` string: Marketing Coverage Repartition label.
      - `name` string: Name of the coverage repartition that helps identify it to underwritters.
    - `payment_modes` object[]: The list of payment modes available for that product.
      - `type` 'APPLE_PAY' | 'BIZUM' | 'CREDIT_CARD' | 'ELECTRONIC_TRANSFERT' | 'GOOGLE_PAY' | 'IDEAL' | 'PAYPAL': The code of the payment modes allowed. The possible values are: - APPLE_PAY: refers to payments with Apple Pay. - BIZUM: refers to payments with Bizum (only Spain). - CREDIT_CARD: refers to payments with Credit and Debit Cards. - ELECTRONIC_TRANSFERT: refers to bank transfers across Europe. - GOOGLE_PAY: refers to payments with Google Pay. - IDEAL: refers to payments with Ideal (mainly Netherlands). - PAYPAL: refers to payments with Paypal.
      - `is_an_express_checkout` boolean: Flag used to identify if this payment method should be called on screen load.
      - `Provider` object: Details about Payment Service Provider used with.
        - `id` string: Beneficiary identifier.
        - `label` string: Name of Provider
    - `yearly_price_details` object: Full yearly prices of a product/addon.
      - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
      - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
      - `price_after_discount_excl_tax` number: Price discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
  - `addons` object[]: Add-ons that customer can add to the product.
    - `code` string: Product code
    - `name` string: Product name
    - `headline` string: Product marketing title.
    - `description` string: Product marketing description.
    - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
    - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
    - `total_discount` number: Total amount of discount, numeric with 2 decimals.
    - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
    - `guarantee_class_prices` object[]: The list of class of guarantees and their impact on the addon price.
      - `code` string: Guarantee class code.
      - `label` string: Guarantee class label.
      - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `coverage_repartition` object[]: The list of coverage repartition and their impact on the product price.
      - `category` string: Description of the category of the coverage repartition.
      - `gross_premium` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `tax_amount` number: Total amount of taxes, numeric with 2 decimals.
      - `tax_type` string: Description of the tax type affected on this coverage.
      - `label` string: Marketing Coverage Repartition label.
      - `name` string: Name of the coverage repartition that helps identify it to underwritters.
    - `cancellation_date` string, date: Cancellation date of the addon - ISO 8601 format (YYYY-MM-DD).
    - `purchase_date` string, date: The date of the subscription (purchase) of the addon - ISO 8601 format (YYYY-MM-DD).
    - `coverage_period` object: The coverage period - ISO 8601 format (YYYY-MM-DD). The coverage start date is the date when it becomes possible for the customer to submit a claim. The coverage end date is the date after which the coverage ends.
      - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
      - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
    - `effective_period` object: The effective period - ISO 8601 format (YYYY-MM-DD) The start date indicates when the contract is starting = activation date. The end date indicates when the contract related to the addon is ending. If the addon is cancelled, then the field is updated
      - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
      - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
    - `yearly_price_details` object: Full yearly prices of a product/addon.
      - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
      - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
      - `price_after_discount_excl_tax` number: Price discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
  - `temporary_addons` object[]: Temporary Add-ons that customer can add to the product.
    - `code` string: Product code
    - `name` string: Product name
    - `headline` string: Product marketing title.
    - `description` string: Product marketing description.
    - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
    - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
    - `total_discount` number: Total amount of discount, numeric with 2 decimals.
    - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
    - `guarantee_class_prices` object[]: The list of class of guarantees and their impact on the addon price.
      - `code` string: Guarantee class code.
      - `label` string: Guarantee class label.
      - `premium_after_discount_excl_tax` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
    - `coverage_repartition` object[]: The list of coverage repartition and their impact on the product price.
      - `category` string: Description of the category of the coverage repartition.
      - `gross_premium` number: Premium discounted excluding taxes, numeric with 2 decimals.
      - `tax_amount` number: Total amount of taxes, numeric with 2 decimals.
      - `tax_type` string: Description of the tax type affected on this coverage.
      - `label` string: Marketing Coverage Repartition label.
      - `name` string: Name of the coverage repartition that helps identify it to underwritters.
    - `cancellation_date` string, date: Cancellation date of the addon - ISO 8601 format (YYYY-MM-DD).
    - `purchase_date` string, date: The date of the subscription (purchase) of the addon - ISO 8601 format (YYYY-MM-DD).
    - `coverage_period` object: The coverage period - ISO 8601 format (YYYY-MM-DD). The coverage start date is the date when it becomes possible for the customer to submit a claim. The coverage end date is the date after which the coverage ends.
      - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
      - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
    - `effective_period` object: The effective period - ISO 8601 format (YYYY-MM-DD) The start date indicates when the contract is starting = activation date. The end date indicates when the contract related to the addon is ending. If the addon is cancelled, then the field is updated
      - `start_date` string, date: Start date - ISO 8601 format (YYYY-MM-DD).
      - `end_date` string, date: End date - ISO 8601 format (YYYY-MM-DD).
    - `yearly_price_details` object: Full yearly prices of a product/addon.
      - `price_after_discount_inc_tax` number: Price amount discounted including taxes, numeric with 2 decimals.
      - `price_before_discount_excl_tax` number: Price not discounted excluding taxes, numeric with 2 decimals.
      - `price_after_discount_excl_tax` number: Price discounted excluding taxes, numeric with 2 decimals.
      - `total_taxes` number: Total amount of taxes, numeric with 2 decimals.
  - `payment` object: Payment summary information.
    - `id` string: Payment Plan Id.
    - `type` 'CREDIT_CARD' | 'DEBIT_CARD' | 'ELECTRONIC_TRANSFER' | 'VIRTUAL_CREDIT_CARD' | 'CASH' | 'CHEQUE' | 'DIRECT_PAYMENT': Payment mode selected.
    - `is_managed_by_axa` boolean: True if the payment is managed by axa. False if the payment is managed by a provider service payment.
    - `payment_reference` string: The payment reference.
    - `payment_periodicity` object: Periodicity of the payment.
      - `value` string: Periodicity value, ISO 8601 format (R[n]/P18Y9M4DT11H9M8S).
      - `amount` number: The amount of recurring payments for the second and subsequent periods. Discounted, including taxes. Numeric value with 2 decimal places.
      - `amount_first_payment` number: The amount of the first recurring payment (which may differ from subsequent payments if, for example, the cents are rounded) Discounted, including taxes. Numeric value with 2 decimal places.
      - `amount_per_period_before_discount` number: The amount of recurring payments for the second and subsequent periods. Not discounted, including taxes. Numeric value with 2 decimal places.
    - `total_amount_incl_tax` number: The total amount to be paid for the policy, discounted, including taxes. Numeric value with 2 decimal places.
    - `has_missing_payment` boolean: False if the last payment is correctly processed, true if not.
    - `has_bad_debt` boolean: True if the balance amount different than zero, false if not.
    - `balance_amount` object: Payment balance, can be a credit balance or a debit balance.
      - `value` number, required: Amount, numeric, with 2 or 3 decimals.
      - `currency` string, required: Currency of the amount. ISO 4217 format (3 letter code).
    - `iban` string: Value of the IBAN number.
    - `taxes_breakdown` object[]: Taxes Breakdown.
      - `code` string, required: The tax code.
      - `amount` object, required: The tax amount.
        - `value` number, required: Amount, numeric, with 2 or 3 decimals.
        - `currency` string, required: Currency of the amount. ISO 4217 format (3 letter code).
  - `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
  - `attachments` object[]: Set of documents linked to 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 of the policy.
    - `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.
  - `renewal_date` string, date: The renewal date of the policy
  - `is_renewable` boolean: Indicates if the policy is renewal.
  - `wallet_informations` object: Wallet data.
    - `pass_url` string: Wallet url used for the client to add the purchased policy

## 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.
- `default`: Default response format.

## Changes

- **2026-08-06** `efe32b811f1d`: 2 breaking, 6 info
  - the `addons/items/code` response property's maxLength was increased from `50` to `255` for the response status `200`
  - the `product/allOf[subschema #1]/code` response property's maxLength was increased from `20` to `255` for the response status `200`
  - added the optional property `addons/items/yearly_price_details` to the response with the `200` status
  - added the optional property `legal_withdrawal_date` to the response with the `200` status
  - …4 more

[Operation history](https://skmtc.dev/axa-assistance/apis/axa-assistance-travel-api/changes/sales/v2/individual/travel/policies/:policy_id/get.md)

---

[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)