---
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}`

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.

---

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