---
title: "Create a medical assistance incident linked to a travel claim."
method: POST
path: "/insurance/travel/v2/claims/{claim_id}/medical_assistance_incidents"
---

# Create a medical assistance incident linked to a travel claim.

`POST /insurance/travel/v2/claims/{claim_id}/medical_assistance_incidents`

Create a medical assistance incident linked to a travel claim.

N.B. This endpoint can only be used when the claims `request_type` is equal to `ASSISTANCE`.

## Path parameters

- `claim_id` string, required — Claim identifier.

## Headers

- `x-environment` 'test' | 'preprod' | 'prod'
- `x-tenant-id` string

## Request body

- object
  - `planned_trip_id` string, required — Identifier of the planned trip where the incident occurred.
  - `provider` union — Provider of the incident. N.B. When no provider is sent, it is considered that AXA Partners has to find the provider for the affected person.
    - object
      - `provider_id` string, required — The identifier of the provider.
    - object
      - `name` string, required — Operational provider name
      - `contact_information` object, required — Information which enable to contact the provider.
        - `address` object — The address of the provider.
          - `street_address` string — Street address.
          - `postal_code` string — Postal code or zip code.
          - `locality` string — Locality.
          - `country` string — Country ISO-3166-1 alpha-2 format (2 letter codes).
          - `subdivision` string — Area of the city.
          - `state` string — Label of the state.
          - `complete_address` string — Complete address.
        - `phone_number` object, required — Phone number of the provider.
          - `international_prefix` string — Prefix to be added to be called from abroad.
          - `number` string, required — Phone number. Can be local or international.
        - `email` string, email — Email of the provider.
      - `category` 'AIR_AMBULANCE' | 'AIR_OPERATOR' | 'BIOLOGY_LABORATORY' | 'FUNERAL_SERVICES' | 'GROUND_AMBULANCE' | 'HOSPITAL' | 'IMAGING_CENTER' | 'MEDICAL_CLINIC' | 'MEDICAL_ESCORT_TEAM' | 'NURSING_CARE' | 'PHARMACY' | 'SKI_RESCUE' | 'SPECIALIST' — The category of the provider.
  - `emergency_assistance_type` 'MEDICAL_ASSISTANCE_NOT_USING_LOCAL_EMERGENCY_NUMBER' | 'MEDICAL_ASSISTANCE_USING_LOCAL_EMERGENCY_NUMBER' | 'NON_URGENT_MEDICAL_ASSISTANCE' — Type of assistance which insured is requesting for. - MEDICAL_ASSISTANCE_NOT_USING_LOCAL_EMERGENCY_NUMBER: Medical Assistance not using Local Emergency Number. The end customer cannot find the country's local emergency phone number and needs AXA's help to arrange medical evacuation. (e.g. is in a remote location in Africa) An emergency assistance case is registered and AXA Partners agent will contact the end customer to provide assistance. - MEDICAL_ASSISTANCE_USING_LOCAL_EMERGENCY_NUMBER: Medical Assistance using local emergency phone number. The end customer seeks medical assistance using the country specific emergency number, (e.g. 911 in the USA). - NON_URGENT_MEDICAL_ASSISTANCE: Non emergency assistance
  - `circumstance` object, required — Circumstance information that lead to the incident creation.
    - `type` 'INJURY' | 'ILLNESS', required — Indicate the cause of the medical assistance incident, it can be: - INJURY: The affected person suffers from an injury; - ILLNESS: The affected person suffers from an illness.
    - `description` string — Description of the incident that lead to the medical condition.
    - `medical_condition` object, required — Information related to the medical conditions suffered by the affected person.
      - `started_at` string, date-time — Date and time when the affected person began to have the medical condition. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ).
      - `description` string, required — Free-text that explains the medical conditions that lead to the assistance.
    - `affected_person` object, required — Information related to the person that suffers from the medical conditions.
      - `involved_person_id` string, required — Identifier of the person that suffers from the medical conditions.
      - `was_inpatient` boolean — Indicates if the affected person was hospitalized.
      - `inpatient_information` object — Additional information on the hospitalization. **N.B. Required when _was_inpatient_ is equal to _true_.
        - `admitted_at` string, date-time, required — Date at which the affected person was admitted to the hospital. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ).
  - `attachments` object[] — List of attachments related to the claim.
    - `attachment_id` string, required — Attachment identifier.
    - `name` string — Name of the attachment.
    - `attachment_category` 'ACCIDENT_BREAKDOWN_REPORT' | 'AIRLINE_CARRIER_REPORT' | 'AIRLINE_PROPERTY_IRREGULARITY_REPORT' | 'BOOKING_INVOICE' | 'CANCELLATION_INVOICE' | 'DAMAGE_REPORT' | 'DEATH_CERTIFICATE' | 'DEBIT_NOTE' | 'DOCTOR_REPORT_OR_HOSPITAL_LETTER' | 'EMPLOYER_LETTER' | 'MEDICAL_CERTIFICATE' | 'MEDICAL_REPORT' | 'OTHER' | 'POLICE_REPORT' | 'PROOF_OF_INCIDENT_LETTER' — Gives category about the attachment.
  - `questions_and_answers` object[] — Information related to the question and answers provided by the reporter.
    - `question_id` string, required — Identifier of the question.
    - `question_text` string, required — The text of the question.
    - `question_type` 'BOOLEAN' | 'DATE' | 'DATE_TIME' | 'DISTANCE' | 'ENUM' | 'LOCATION' | 'MONETARY_AMOUNT' | 'NUMBER' | 'STRING' | 'WEIGHT', required — The question type.
    - `priority` integer, required — The priority of the question, the lower the higher. N.B. 0 means that the question has no priority.
    - `enumeration_answers` object[] — List of the answers. Required when `question_type` is equal to `ENUM`.
      - `answer_text` string, required — The text of the answer to be displayed to the user.
      - `answer_id` string, required — Identifier of the answer.
      - `is_selected` boolean — Indicates if the answer was selected by the reporter: - true: the answer was selected by the reporter; - false: the answer wasn't selected by the reporter.
    - `answered_text` string — Text of the answer. Required when `question_type` is equal to `STRING` or `LOCATION`.
    - `answered_amount` object — Answered monetary amount. Required when `question_type` is equal to `MONETARY_AMOUNT`.
      - `value` number, required — Amount, numeric, with 2 or 3 decimals.
      - `currency` string, required — Currency of the amount. ISO 4217 format (3 letter code).
    - `answered_distance` object — Answered distance. Required when `question_type` is equal to `DISTANCE`.
      - `value` number, required — Measured distance.
      - `unit` 'km' | 'm' | '[ft_i]', Unified Code for Units of Measure (UCUM) in case sensitive., required — Unit of the measure code. Available values: - \[ft_i]: Foot; - m: Meter; - km: Kilometer.
    - `answered_boolean` boolean — Answered boolean. Required when `question_type` is equal to `BOOLEAN`.
    - `answered_weight` object — Answered weight. Required when `question_type` is equal to `WEIGHT`.
      - `value` number, required — Measured weight.
      - `unit` 'kg' | '[lb_av]' | '[stone_av]', Unified Code for Units of Measure (UCUM) in case sensitive., required — Unit of the measure code. Available values: - kg: Kilograms; - \[lb_av]: Pound; - \[stone_av]: Stone.
    - `answered_number` number — Answered number. Required when `question_type` is equal to `NUMBER`.
    - `answered_date` string, date — Answered date. ISO 8601 format (YYYY-MM-DD). Required when `question_type` is equal to `DATE`.
    - `answered_date_time` string, date-time — Answered date-time. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ). Required when `question_type` is equal to `DATE_TIME`.

## Response `201`

Medical assistance incident created.

- object
  - `incident_id` string — Identifier of the incident.
  - `planned_trip_id` string — Identifier of the planned trip where the incident occurred.
  - `circumstance` object — Circumstance information that lead to the assistance incident creation.
    - `type` 'INJURY' | 'ILLNESS', required — Indicate the cause of the medical assistance incident, it can be: - INJURY: The affected person suffers from an injury; - ILLNESS: The affected person suffers from an illness.
    - `description` string — Description of the incident that lead to the medical condition.
    - `medical_condition` object, required — Information related to the medical conditions suffered by the affected person.
      - `started_at` string, date-time — Date and time when the affected person began to have the medical condition. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ).
      - `description` string, required — Free-text that explains the medical conditions that lead to the assistance.
    - `affected_person` object, required — Information related to the person that suffers from the medical conditions.
      - `involved_person_id` string, required — Identifier of the person that suffers from the medical conditions.
      - `was_inpatient` boolean — Indicates if the affected person was hospitalized.
      - `inpatient_information` object — Additional information on the hospitalization. **N.B. Required when _was_inpatient_ is equal to _true_.
        - `admitted_at` string, date-time, required — Date at which the affected person was admitted to the hospital. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ).
  - `provider` object — Provider of the assistance incident.
    - `provider_id` string, required — The identifier of the provider.
  - `attachments` object[] — List of attachments related to the claim.
    - `attachment_id` string, required — Attachment identifier.
    - `name` string — Name of the attachment.
    - `attachment_category` 'ACCIDENT_BREAKDOWN_REPORT' | 'AIRLINE_CARRIER_REPORT' | 'AIRLINE_PROPERTY_IRREGULARITY_REPORT' | 'BOOKING_INVOICE' | 'CANCELLATION_INVOICE' | 'DAMAGE_REPORT' | 'DEATH_CERTIFICATE' | 'DEBIT_NOTE' | 'DOCTOR_REPORT_OR_HOSPITAL_LETTER' | 'EMPLOYER_LETTER' | 'MEDICAL_CERTIFICATE' | 'MEDICAL_REPORT' | 'OTHER' | 'POLICE_REPORT' | 'PROOF_OF_INCIDENT_LETTER' — Gives category about the attachment.
  - `questions_and_answers` object[] — Information related to the question and answers provided by the reporter.
    - `question_id` string, required — Identifier of the question.
    - `question_text` string, required — The text of the question.
    - `question_type` 'BOOLEAN' | 'DATE' | 'DATE_TIME' | 'DISTANCE' | 'ENUM' | 'LOCATION' | 'MONETARY_AMOUNT' | 'NUMBER' | 'STRING' | 'WEIGHT', required — The question type.
    - `priority` integer, required — The priority of the question, the lower the higher. N.B. 0 means that the question has no priority.
    - `enumeration_answers` object[] — List of the answers. Required when `question_type` is equal to `ENUM`.
      - `answer_text` string, required — The text of the answer to be displayed to the user.
      - `answer_id` string, required — Identifier of the answer.
      - `is_selected` boolean — Indicates if the answer was selected by the reporter: - true: the answer was selected by the reporter; - false: the answer wasn't selected by the reporter.
    - `answered_text` string — Text of the answer. Required when `question_type` is equal to `STRING` or `LOCATION`.
    - `answered_amount` object — Answered monetary amount. Required when `question_type` is equal to `MONETARY_AMOUNT`.
      - `value` number, required — Amount, numeric, with 2 or 3 decimals.
      - `currency` string, required — Currency of the amount. ISO 4217 format (3 letter code).
    - `answered_distance` object — Answered distance. Required when `question_type` is equal to `DISTANCE`.
      - `value` number, required — Measured distance.
      - `unit` 'km' | 'm' | '[ft_i]', Unified Code for Units of Measure (UCUM) in case sensitive., required — Unit of the measure code. Available values: - \[ft_i]: Foot; - m: Meter; - km: Kilometer.
    - `answered_boolean` boolean — Answered boolean. Required when `question_type` is equal to `BOOLEAN`.
    - `answered_weight` object — Answered weight. Required when `question_type` is equal to `WEIGHT`.
      - `value` number, required — Measured weight.
      - `unit` 'kg' | '[lb_av]' | '[stone_av]', Unified Code for Units of Measure (UCUM) in case sensitive., required — Unit of the measure code. Available values: - kg: Kilograms; - \[lb_av]: Pound; - \[stone_av]: Stone.
    - `answered_number` number — Answered number. Required when `question_type` is equal to `NUMBER`.
    - `answered_date` string, date — Answered date. ISO 8601 format (YYYY-MM-DD). Required when `question_type` is equal to `DATE`.
    - `answered_date_time` string, date-time — Answered date-time. UTC datetime, RFC3339 format (YYYY-MM-DDTHH:mm:ssZ). Required when `question_type` is equal to `DATE_TIME`.

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