--- 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` ## Request - Base URL: `https://sandbox.api.axapartners.com` - URL: `https://sandbox.api.axapartners.com/insurance/travel/v2/claims/{claim_id}/medical_assistance_incidents` - Auth: OAuth 2 - Client credentials - Token URL: `https://sandbox.auth.api.axapartners.com/oauth/token` scopes: `urn:axa.partners.insurance.travel.claims.write` 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 involved person. - `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: Identifier of the attachment. - `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 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 involved person. - `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: Identifier of the attachment. - `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. ## Changes - **2026-09-04** `df05aef69b3f`: 5 breaking, 1 warning, 9 info - added the new required request property `circumstance/affected_person` - added the new required request property `circumstance/medical_condition` - the `circumstance` request property type changed from no type to `object` - the `circumstance/allOf[subschema #1]/affected_person` response's property type changed from no type to `object` for status `201` - …11 more - **2026-08-06** `efe32b811f1d`: 1 info - endpoint added [Operation history](https://skmtc.dev/axa-assistance/apis/axa-assistance-travel-api/changes/insurance/travel/v2/claims/:claim_id/medical_assistance_incidents/post.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)